1 |
package Frey::CouchAPI; |
package Frey::CouchAPI; |
2 |
|
|
3 |
|
=head1 DESCRIPTION |
4 |
|
|
5 |
|
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 |
14 |
|
|
15 |
|
=cut |
16 |
|
|
17 |
use warnings; |
use warnings; |
18 |
use strict; |
use strict; |
19 |
|
|
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; |
120 |
|
|
121 |
} elsif ( $url =~ m{($regex_dbs)/$} ) { |
} elsif ( $url =~ m{($regex_dbs)/$} ) { |
122 |
|
|
123 |
|
=head2 Database |
124 |
|
|
125 |
|
L<http://wiki.apache.org/couchdb/HTTP_database_API> except compaction |
126 |
|
|
127 |
|
=cut |
128 |
|
|
129 |
my $database = $1; |
my $database = $1; |
130 |
my $dir = "$config->{path}/$database"; |
|
131 |
|
my $dir = "$path/$database"; |
132 |
|
|
133 |
if ( $method eq 'GET' ) { |
if ( $method eq 'GET' ) { |
134 |
$json = database_get( $database ); |
$json = database_get( $database ); |
136 |
if ( ! -e $dir ) { |
if ( ! -e $dir ) { |
137 |
$status = 404; |
$status = 404; |
138 |
} else { |
} else { |
139 |
remove_tree($dir) && ok || { $status = 501 }; |
remove_tree($dir); |
140 |
|
if ( ! -d $dir ) { |
141 |
|
ok; |
142 |
|
} else { |
143 |
|
$status = 500; |
144 |
|
} |
145 |
} |
} |
146 |
} elsif ( $method eq 'PUT' ) { |
} elsif ( $method eq 'PUT' ) { |
147 |
if ( ! -e $dir ) { |
if ( -e $dir ) { |
|
make_path($dir) && ok && warn "created $dir" || { $status = 501 }; |
|
|
} else { |
|
148 |
$status = 412; |
$status = 412; |
149 |
|
} else { |
150 |
|
make_path($dir); |
151 |
|
if ( -e $path ) { |
152 |
|
ok; |
153 |
|
$status = 201; |
154 |
|
} else { |
155 |
|
$status = 500; |
156 |
|
} |
157 |
} |
} |
158 |
} |
} |
159 |
|
|
160 |
} elsif ( $url =~ m{($regex_dbs)/([^?]+)\??(.+)?$} ) { |
} elsif ( $url =~ m{($regex_dbs)/([^?]+)\??(.+)?$} ) { |
161 |
my ($database,$id,$args) = ($1,$2,$3); |
my ($database,$id,$args) = ($1,$2,$3); |
162 |
|
|
163 |
|
=head2 Document |
164 |
|
|
165 |
|
L<http://wiki.apache.org/couchdb/HTTP_Document_API> |
166 |
|
|
167 |
|
=cut |
168 |
|
|
169 |
my $arg; |
my $arg; |
170 |
if ( $args ) { |
if ( $args ) { |
171 |
foreach my $a ( split(/[&;]/,$args) ) { |
foreach my $a ( split(/[&;]/,$args) ) { |
175 |
} |
} |
176 |
} |
} |
177 |
|
|
|
my $path = $config->{path}; |
|
178 |
warn "ERROR: path $path doesn't exist\n" unless -e $path; |
warn "ERROR: path $path doesn't exist\n" unless -e $path; |
179 |
|
|
180 |
my $p = "$path/$database/$id"; |
my $p = "$path/$database/$id"; |
181 |
warn "## database: $database id: $id -> $p [$args]\n"; |
warn "## database: $database id: $id -> $p ", dump( $arg ),"\n"; |
182 |
|
|
183 |
|
|
184 |
if ( $id =~ m{_all_docs(\w+)?$} ) { |
if ( $id =~ m{_all_docs(\w+)?$} ) { |
186 |
my $by = $1; |
my $by = $1; |
187 |
my $offset = 0; |
my $offset = 0; |
188 |
my $startkey = delete $arg->{startkey}; |
my $startkey = delete $arg->{startkey}; |
189 |
warn "STARTKEY: $startkey\n"; |
my $endkey = delete $arg->{endkey}; |
190 |
|
my $limit = delete $arg->{limit}; |
191 |
my $total_rows = 0; |
my $total_rows = 0; |
192 |
|
|
193 |
my @docs = grep { length $_ } map { |
my @docs = grep { length $_ } map { |
194 |
|
return '' if defined $limit && $total_rows == $limit; |
195 |
|
|
196 |
s{^$path/$database/}{}; |
s{^$path/$database/}{}; |
197 |
|
return '' if defined $endkey && $_ gt $endkey; |
198 |
|
|
199 |
if ( $startkey ) { |
if ( $startkey ) { |
200 |
if ( $_ >= $startkey ) { |
if ( $_ ge $startkey ) { |
201 |
$total_rows++; |
$total_rows++; |
202 |
$_; |
$_; |
203 |
} else { |
} else { |
204 |
$offset++; |
$offset++; |
205 |
|
return ''; |
206 |
} |
} |
207 |
} else { |
} else { |
208 |
$total_rows++; |
$total_rows++; |
209 |
$_; |
$_; |
210 |
} |
} |
211 |
|
|
212 |
} glob( "$path/$database/*" ); |
} glob( "$path/$database/*" ); |
213 |
|
|
214 |
warn "## docs ", dump( @docs ) if $debug; |
warn "## docs $startkey -> $endkey limit $limit ", dump( @docs ); # if $debug; |
215 |
|
|
216 |
$json = { |
$json = { |
217 |
total_rows => $total_rows, |
total_rows => $total_rows, |
235 |
id => $id, |
id => $id, |
236 |
key => $id, |
key => $id, |
237 |
value => { |
value => { |
238 |
rev => (stat($p))[9], # mtime |
rev => file_rev $p, |
239 |
} |
} |
240 |
}; |
}; |
241 |
} |
} |
252 |
|
|
253 |
} elsif ( $method eq 'PUT' ) { |
} elsif ( $method eq 'PUT' ) { |
254 |
|
|
255 |
warn "## ",dump( $tx->req ) if $debug; |
warn "## ",dump( $tx->req ); # if $debug; |
256 |
|
|
257 |
my $data = $tx->req->content->file->slurp; |
my $data = $tx->req->content->file->slurp; |
258 |
|
|
259 |
Storable::store( from_json($data), $p ); |
Storable::store( from_json($data), $p ); |
260 |
warn "store $p ", -s $p, " bytes: $data\n"; |
my $rev = file_rev $p; |
261 |
|
warn "store $p $rev size ", -s $p, " bytes | $data\n"; |
262 |
|
|
263 |
|
$status = 201; # Created |
264 |
|
$json = { |
265 |
|
id => $id, |
266 |
|
ok => JSON::true, |
267 |
|
rev => $rev, |
268 |
|
}; |
269 |
|
|
270 |
} elsif ( $method eq 'GET' ) { |
} elsif ( $method eq 'GET' ) { |
271 |
if ( ! -e $p ) { |
if ( ! -e $p ) { |
272 |
$status = 404; |
$status = 404; |
273 |
} else { |
} else { |
274 |
warn "retrive $p ", -s $p, " bytes\n"; |
warn "retrive $p ", -s $p, " bytes\n"; |
275 |
$json = Storable::retrieve( $p ); |
$json = Storable::retrieve( $p ); |
276 |
|
if ( delete $arg->{revs_info} ) { |
277 |
|
my $rev = file_rev $p; |
278 |
|
$json->{_rev} = $rev; |
279 |
|
$json->{_revs_info} = [ |
280 |
|
{ rev => $rev, status => 'available' } |
281 |
|
]; |
282 |
|
} |
283 |
|
$status = 200; |
284 |
|
|
285 |
} |
} |
286 |
} elsif ( $method eq 'DELETE' ) { |
} elsif ( $method eq 'DELETE' ) { |
287 |
if ( -e $p ) { |
if ( -e $p ) { |
288 |
unlink $p || { $status = 501 }; |
unlink $p && ok || { $status = 500 }; |
289 |
} else { |
} else { |
290 |
$status = 404; |
$status = 404; |
291 |
} |
} |
292 |
|
} elsif ( $method eq 'POST' ) { |
293 |
|
$json = { total_rows => 0, offset => 0 }; |
294 |
|
$status = 202; # FIXME implement real view server and return 200 |
295 |
} else { |
} else { |
296 |
$status = 501; |
$status = 501; |
297 |
} |
} |
300 |
|
|
301 |
} |
} |
302 |
|
|
303 |
if ( $status >= 400 && $status < 500 && ! defined $json) { |
$json = { error => 'not_found', reason => 'Missing' } if $status == 404; |
304 |
$json = { error => 'not_found', reason => 'Missing' }; |
|
305 |
warn "fake $status"; |
if ( $method =~ m{(DELETE|PUT)} ) { |
306 |
|
$tx->res->headers->add_line( 'Location' => $tx->req->url->to_abs ); |
307 |
} |
} |
308 |
|
|
309 |
$tx->res->code( $status ); |
$tx->res->code( $status ); |
310 |
$tx->res->headers->content_type( 'text/json' ); |
$tx->res->headers->content_type( 'text/plain;charset=utf-8' ); |
311 |
my $body = to_json $json; |
my $body = to_json $json; |
312 |
$tx->res->body( $body ); |
$tx->res->body( $body ); |
313 |
warn "CouchDB API: $method $url $status $body\n"; |
$tx->res->headers->add_line( 'Cache-Control' => 'must-revalidate' ); |
314 |
|
$tx->res->headers->add_line( 'Server' => "Frey::CouchAPI/$VERSION" ); |
315 |
|
|
316 |
|
print "$method $url $status\n$body\n"; |
317 |
|
|
318 |
|
warn "## headers ", $tx->res->headers->to_string; |
319 |
|
|
320 |
return $tx; |
return $tx; |
321 |
|
|
322 |
} |
} |
344 |
} |
} |
345 |
|
|
346 |
1; |
1; |
347 |
|
__END__ |
348 |
|
|
349 |
|
=head1 SEE ALSO |
350 |
|
|
351 |
|
L<http://wiki.apache.org/couchdb/Reference> |
352 |
|
|