Mojoliciousドキュメント日本語訳

Mojo::JSON::Pointer - JSONポインタ

使い方

use Mojo::JSON::Pointer;

my $pointer = Mojo::JSON::Pointer->new({foo => [23, 'bar']});
say $pointer->get('/foo/1');
say 'Contains "/foo".' if $pointer->contains('/foo');

説明

Mojo::JSON::Pointerは、RFC 6901の緩やかな実装です。

属性

Mojo::JSON::Pointerは次の属性を実装しています。

data

my $data = $pointer->data;
$pointer = $pointer->data({foo => 'bar'});

処理されるデータ構造。

メソッド

contains

my $bool = $pointer->contains('/foo/1');

データ(data)がJSONポインタで識別される値を含んでいるかをチェックします。

# 真
Mojo::JSON::Pointer->new('just a string')->contains('');
Mojo::JSON::Pointer->new({'♥' => 'mojolicious'})->contains('/♥');
Mojo::JSON::Pointer->new({foo => 'bar', baz => [4, 5]})->contains('/foo');
Mojo::JSON::Pointer->new({foo => 'bar', baz => [4, 5]})->contains('/baz/1');

# 偽
Mojo::JSON::Pointer->new({'♥' => 'mojolicious'})->contains('/☃');
Mojo::JSON::Pointer->new({foo => 'bar', baz => [4, 5]})->contains('/bar');
Mojo::JSON::Pointer->new({foo => 'bar', baz => [4, 5]})->contains('/baz/9');

get

my $value = $pointer->get($data, '/foo/bar');

与えられたJSONポインタによって識別されるデータ(data)から値を抽出します。

# "mojolicious"
Mojo::JSON::Pointer->new({'♥' => 'mojolicious'})->get('/♥');

# "bar"
Mojo::JSON::Pointer->new({foo => 'bar', baz => [4, 5, 6]})->get('/foo');

# "4"
Mojo::JSON::Pointer->new({foo => 'bar', baz => [4, 5, 6]})->get('/baz/0');

# "6"
Mojo::JSON::Pointer->new({foo => 'bar', baz => [4, 5, 6]})->get('/baz/2');

new

my $pointer = Mojo::JSON::Pointer->new;
my $pointer = Mojo::JSON::Pointer->new({foo => 'bar'});

新しいMojo::JSON::Pointerオブジェクトを生成します。

参考

Mojolicious, Mojolicious::Guides, http://mojolicio.us.

(Mojolicious 8.12を反映。2019年5月22日更新)