2 |
|
|
3 |
=head1 DESCRIPTION |
=head1 DESCRIPTION |
4 |
|
|
5 |
This is REST wrapper using L<Mojo::Transaction> to implement Apache's CouchDB API |
This is REST wrapper using following L<Mojo> implement Apache's CouchDB API |
6 |
|
|
7 |
|
|
8 |
|
L<Mojo::URL> |
9 |
|
|
10 |
|
L<Mojo::Transaction> |
11 |
|
|
12 |
|
|
13 |
=head1 Supported HTTP API |
=head1 Supported HTTP API |
14 |
|
|
23 |
use File::Path qw(make_path remove_tree); |
use File::Path qw(make_path remove_tree); |
24 |
use Storable; |
use Storable; |
25 |
|
|
26 |
our $VERSION = '0.1'; |
our $VERSION = '0.2'; |
27 |
$VERSION .= ' on Frey ' . $Frey::VERSION; |
$VERSION .= " (Frey $Frey::VERSION)" if $Frey::VERSION; |
28 |
|
|
29 |
our $debug = $Frey::debug || 0; |
our $debug = $Frey::debug || 0; |
30 |
|
|
55 |
my $regex_dbs = '[a-z][a-z0-9_\$\(\)\+\-/]+'; |
my $regex_dbs = '[a-z][a-z0-9_\$\(\)\+\-/]+'; |
56 |
|
|
57 |
our $json = {}; |
our $json = {}; |
58 |
our $status = 500; |
our $status; |
59 |
|
|
60 |
sub ok { |
sub ok { |
61 |
$json = { ok => JSON::true }; |
$json = { ok => JSON::true }; |
62 |
$status = 200; |
$status = 200; |
63 |
|
warn "ok from ",join(' ',caller),$/; |
64 |
} |
} |
65 |
|
|
66 |
|
sub file_rev { (stat($_[0]))[9] } # mtime |
67 |
|
|
68 |
sub dispatch { |
sub dispatch { |
69 |
my ($self,$tx) = @_; |
my ($self,$tx) = @_; |
70 |
|
|
71 |
|
$status = 500; # Internal Error |
72 |
|
|
73 |
my $url = $tx->req->url->to_string; |
my $url = $tx->req->url->to_string; |
74 |
$url = uri_unescape( $url ); |
$url = uri_unescape( $url ); |
75 |
my $method = $tx->req->method; |
my $method = $tx->req->method; |
76 |
|
my $path = $config->{path}; |
77 |
|
|
78 |
if ( $url eq '/' ) { |
if ( $url eq '/' ) { |
79 |
$json = { |
$json = { |
80 |
couchdb => "Welcome", |
couchdb => "Welcome", |
81 |
version => "CouchAPI $VERSION", |
version => "CouchAPI $VERSION", |
82 |
} |
}; |
83 |
|
$status = 200; |
84 |
} elsif ( $url eq '/_all_dbs' ) { |
} elsif ( $url eq '/_all_dbs' ) { |
85 |
$json = [ @all_dbs ]; |
$json = [ @all_dbs ]; |
86 |
$status = 200; |
$status = 200; |
118 |
$status = 501; |
$status = 501; |
119 |
} |
} |
120 |
|
|
|
} elsif ( $url =~ m{($regex_dbs)/$} ) { |
|
|
|
|
121 |
=head2 Database |
=head2 Database |
122 |
|
|
123 |
L<http://wiki.apache.org/couchdb/HTTP_database_API> except compaction |
L<http://wiki.apache.org/couchdb/HTTP_database_API> except compaction |
124 |
|
|
125 |
=cut |
=cut |
126 |
|
|
127 |
|
} elsif ( |
128 |
|
$url =~ m{($regex_dbs)/$} |
129 |
|
# DELETE doesn't have trailing slash |
130 |
|
|| $method eq 'DELETE' && $url =~ m{($regex_dbs)$} |
131 |
|
) { |
132 |
|
|
133 |
my $database = $1; |
my $database = $1; |
134 |
my $dir = "$config->{path}/$database"; |
|
135 |
|
my $dir = "$path/$database"; |
136 |
|
|
137 |
if ( $method eq 'GET' ) { |
if ( $method eq 'GET' ) { |
138 |
$json = database_get( $database ); |
$json = database_get( $database ); |
140 |
if ( ! -e $dir ) { |
if ( ! -e $dir ) { |
141 |
$status = 404; |
$status = 404; |
142 |
} else { |
} else { |
143 |
remove_tree($dir) && ok || { $status = 501 }; |
remove_tree($dir); |
144 |
|
if ( ! -d $dir ) { |
145 |
|
ok; |
146 |
|
} else { |
147 |
|
$status = 500; |
148 |
|
} |
149 |
} |
} |
150 |
} elsif ( $method eq 'PUT' ) { |
} elsif ( $method eq 'PUT' ) { |
151 |
if ( ! -e $dir ) { |
if ( -e $dir ) { |
|
make_path($dir) && ok && warn "created $dir" || { $status = 501 }; |
|
|
} else { |
|
152 |
$status = 412; |
$status = 412; |
153 |
|
} else { |
154 |
|
make_path($dir); |
155 |
|
if ( -e $path ) { |
156 |
|
ok; |
157 |
|
$status = 201; |
158 |
|
} else { |
159 |
|
$status = 500; |
160 |
|
} |
161 |
} |
} |
162 |
} |
} |
163 |
|
|
164 |
|
warn "## database $database $status ",dump( $json ); |
165 |
|
|
166 |
} elsif ( $url =~ m{($regex_dbs)/([^?]+)\??(.+)?$} ) { |
} elsif ( $url =~ m{($regex_dbs)/([^?]+)\??(.+)?$} ) { |
167 |
my ($database,$id,$args) = ($1,$2,$3); |
my ($database,$id,$args) = ($1,$2,$3); |
168 |
|
|
181 |
} |
} |
182 |
} |
} |
183 |
|
|
|
my $path = $config->{path}; |
|
184 |
warn "ERROR: path $path doesn't exist\n" unless -e $path; |
warn "ERROR: path $path doesn't exist\n" unless -e $path; |
185 |
|
|
186 |
my $p = "$path/$database/$id"; |
my $p = "$path/$database/$id"; |
187 |
warn "## database: $database id: $id -> $p ", dump( $arg ),"\n"; |
warn "## database: $database id: $id -> $p ", dump( $arg ),"\n"; |
188 |
|
|
189 |
|
|
190 |
if ( $id =~ m{_all_docs(\w+)?$} ) { |
if ( $id =~ m{_all_docs(\w*)$} ) { |
191 |
|
|
192 |
my $by = $1; |
my $by = $1; |
193 |
my $offset = 0; |
my $offset = 0; |
197 |
my $total_rows = 0; |
my $total_rows = 0; |
198 |
|
|
199 |
my @docs = grep { length $_ } map { |
my @docs = grep { length $_ } map { |
200 |
return '' if defined $limit && $total_rows == $limit; |
|
201 |
|
if ( $limit > 0 && $total_rows == $limit ) { |
202 |
|
''; |
203 |
|
} else { |
204 |
|
|
205 |
s{^$path/$database/}{}; |
s{^$path/$database/}{}; |
|
return '' if defined $endkey && $_ gt $endkey; |
|
206 |
|
|
207 |
if ( $startkey ) { |
if ( defined $endkey && $_ gt $endkey ) { |
208 |
if ( $_ ge $startkey ) { |
''; |
209 |
|
} elsif ( $startkey ) { |
210 |
|
if ( $_ ge $startkey ) { |
211 |
|
$total_rows++; |
212 |
|
$_; |
213 |
|
} else { |
214 |
|
$offset++; |
215 |
|
''; |
216 |
|
} |
217 |
|
} else { |
218 |
$total_rows++; |
$total_rows++; |
219 |
$_; |
$_; |
|
} else { |
|
|
$offset++; |
|
|
return ''; |
|
220 |
} |
} |
|
} else { |
|
|
$total_rows++; |
|
|
$_; |
|
221 |
} |
} |
222 |
|
|
223 |
} glob( "$path/$database/*" ); |
} glob( "$path/$database/*" ); |
224 |
|
|
225 |
|
|
226 |
warn "## docs $startkey -> $endkey limit $limit ", dump( @docs ); # if $debug; |
warn "## docs $startkey -> $endkey limit $limit ", dump( @docs ); # if $debug; |
227 |
|
|
228 |
$json = { |
$json = { |
247 |
id => $id, |
id => $id, |
248 |
key => $id, |
key => $id, |
249 |
value => { |
value => { |
250 |
rev => (stat($p))[9], # mtime |
rev => file_rev $p, |
251 |
} |
} |
252 |
}; |
}; |
253 |
} |
} |
262 |
push @{ $json->{rows} }, $rows->{$id}; |
push @{ $json->{rows} }, $rows->{$id}; |
263 |
} |
} |
264 |
|
|
265 |
|
$status = 200; |
266 |
|
|
267 |
} elsif ( $method eq 'PUT' ) { |
} elsif ( $method eq 'PUT' ) { |
268 |
|
|
269 |
warn "## ",dump( $tx->req ) if $debug; |
warn "## ",dump( $tx->req ) if $debug; |
270 |
|
|
271 |
my $data = $tx->req->content->file->slurp; |
my $data = $tx->req->content->file->slurp; |
272 |
|
|
273 |
|
my $db_path = "$path/$database"; |
274 |
|
make_path $db_path unless -e $db_path; |
275 |
|
|
276 |
Storable::store( from_json($data), $p ); |
Storable::store( from_json($data), $p ); |
277 |
warn "store $p ", -s $p, " bytes: $data\n"; |
my $rev = file_rev $p; |
278 |
|
warn "store $p $rev size ", -s $p, " bytes | $data\n"; |
279 |
|
|
280 |
|
$status = 201; # Created |
281 |
|
$json = { |
282 |
|
id => $id, |
283 |
|
ok => JSON::true, |
284 |
|
rev => $rev, |
285 |
|
}; |
286 |
|
|
287 |
} elsif ( $method eq 'GET' ) { |
} elsif ( $method eq 'GET' ) { |
288 |
if ( ! -e $p ) { |
if ( ! -e $p ) { |
289 |
$status = 404; |
$status = 404; |
290 |
} else { |
} else { |
291 |
warn "retrive $p ", -s $p, " bytes\n"; |
warn "retrive $p ", -s $p, " bytes\n"; |
292 |
$json = Storable::retrieve( $p ); |
$json = Storable::retrieve( $p ); |
293 |
|
if ( delete $arg->{revs_info} ) { |
294 |
|
my $rev = file_rev $p; |
295 |
|
$json->{_rev} = $rev; |
296 |
|
$json->{_revs_info} = [ |
297 |
|
{ rev => $rev, status => 'available' } |
298 |
|
]; |
299 |
|
} |
300 |
|
$status = 200; |
301 |
|
|
302 |
} |
} |
303 |
} elsif ( $method eq 'DELETE' ) { |
} elsif ( $method eq 'DELETE' ) { |
304 |
if ( -e $p ) { |
if ( -e $p ) { |
305 |
unlink $p || { $status = 501 }; |
unlink $p && ok || { $status = 500 }; |
306 |
} else { |
} else { |
307 |
$status = 404; |
$status = 404; |
308 |
} |
} |
309 |
|
} elsif ( $method eq 'POST' ) { |
310 |
|
$json = { total_rows => 0, offset => 0 }; |
311 |
|
$status = 202; # FIXME implement real view server and return 200 |
312 |
} else { |
} else { |
313 |
$status = 501; |
$status = 501; |
314 |
} |
} |
315 |
|
|
316 |
warn "WARNING: arg left from $url = ",dump( $arg ),$/ if keys %$arg; |
if ( keys %$arg ) { |
317 |
|
warn "WARNING: arg left from $url = ",dump( $arg ),$/; |
318 |
|
$status = 501; |
319 |
|
} |
320 |
|
|
321 |
} |
} |
322 |
|
|
323 |
if ( $status >= 400 && $status < 500 && ! defined $json) { |
$json = { error => 'not_found', reason => 'Missing' } if $status == 404; |
324 |
$json = { error => 'not_found', reason => 'Missing' }; |
|
325 |
warn "fake $status"; |
if ( $method =~ m{(DELETE|PUT)} ) { |
326 |
|
$tx->res->headers->add_line( 'Location' => $tx->req->url->to_abs ); |
327 |
} |
} |
328 |
|
|
329 |
$tx->res->code( $status ); |
$tx->res->code( $status ); |
330 |
$tx->res->headers->content_type( 'text/json' ); |
$tx->res->headers->content_type( 'text/plain;charset=utf-8' ); |
331 |
my $body = to_json $json; |
my $body = to_json $json; |
332 |
$tx->res->body( $body ); |
$tx->res->body( $body ); |
333 |
warn "CouchDB API: $method $url $status $body\n"; |
$tx->res->headers->add_line( 'Cache-Control' => 'must-revalidate' ); |
334 |
|
$tx->res->headers->add_line( 'Server' => "Frey::CouchAPI/$VERSION" ); |
335 |
|
|
336 |
|
print "$method $url $status\n$body\n"; |
337 |
|
|
338 |
|
warn "## headers ", $tx->res->headers->to_string; |
339 |
|
|
340 |
return $tx; |
return $tx; |
341 |
|
|
342 |
} |
} |