これは、ツリーに似たデータ構造を人間に優しい形式で1行として表すための形式です。これは、「application / x-www-form-urlencoded」形式の一般化であり、その結果、下位互換性があります。 Hiqusは、キーと値のペアの形式でデータを表示するという同じ原則に基づいていますが、唯一の違いは、キーを複合または空にすることができることです。

この形式は、Yandex（http://yandex.ru/yandsearch?date=within&text=hiqus&from_day=28&from_month=4&from_year=2009)、Google（http://www.google.ru/search?as_q=hiqus&hl= ru＆num = 10＆as_qdr = all）と、クエリ文字列で階層データを渡す必要がある他の多くのユーザー。例外は、独自の形式が伝統的に使用されているPHPサイトです。これはあまり明確ではありません（たとえば、私はそれをすぐに見つけられませんでしたが、次のようになります。？User％5Bid％5D = 123＆user％5Bname％5D = Nick）。

説明

hiqus文字列は、通常のクエリ文字列でよく知られているアンパサンド、従来のCNCのスラッシュ、コマンドラインからのスペース、Cookie文字列からのセミコロンで再生できる区切り文字で区切られた1つ以上の部分で構成され、さて、ヒープに-垂直線;-)

各「ピース」は、意味そのものと、その前にあるパスで構成されています。パスが空の場合があります。パスの各要素の後には、特別な区切り記号が必要です。これは、通常のクエリ文字列でよく知られている等号、JSONでのコロン、およびHTMLフォームで便利なアンダースコアです（送信中にエンコードされないため）。

値とパスの要素は、URI仕様に従ってパーセントでエンコードする必要があります。ただし、パーサーにとって重要なのは上記の特殊文字のみです。残りを選別するかどうかは、hiqus文字列がどこでどのように使用されるかによって異なります。

パス要素は空の文字列にすることができ、代わりに自動的に生成された番号が使用されます。たとえば、「a == 1」は、解析時の「a = 0 = 1」と同等です。

パスに要素が1つしかなく、その要素が空であっても、その後に置かれるセパレータは省略できます。たとえば、「= blogs / = webstandards」は「blogs / webstandards」と同等です。

「Pieces」はターゲットツリーに順番に追加されます。これにより、値や、以前の値のサブツリーさえも上書きできます。たとえば、「a = b = 1 / a = 1」は「a = 1」と同等です。

例

このようなcncがあるとします：/ブログ/ webstandards / 92300 /

hiqusとして解析すると、{'0'： 'blogs'、 '1'： 'webstandarts'、 '2'： '92300'}のようなJSON表現のオブジェクトが得られます

フォームを送信し、次のクエリ文字列を受け取ったとします：q = hiqus＆target_type = blogs＆target_subtype = offtopic

解析の結果は次のようになります：{q： 'hiqus'、target：{type： 'blogs'、subtype： 'offtopic'}}

次のパラメーターを渡すことにより、コンソールからスクリプトを呼び出したとします：list users sex = female limit = 100

解析後、{'0'： 'list'、 '1'： 'users'、 'sex'： 'female'、limit： '100'}を取得します

このようなクッキーを取得しましょう：sid = 1234; login = tenshi

解凍して取得：{sid： '1234'、login： 'tenshi'}

JavaScriptリファレンス実装

var Hiqus= new function (){ Version: 1 Description: "parse, serialize and merge any 'HIerarhical QUery String'" License: 'public domain' Implementation: var sepHiqusList= '/|; &' var sepPathList= '=:_' var sepHiqusDefault= sepHiqusList.charAt(0) var sepPathDefault= sepPathList.charAt(0) var sepHiqusRegexp= RegExp( '[' + sepHiqusList + ']' , 'g' ) var sepPathRegexp= RegExp( '[' + sepPathList + ']' , 'g' ) var encode= function ( str ){ return encodeURIComponent( str ).split( '_' ).join( '%5F' ) } var decode= function ( str ){ return decodeURIComponent( str ) } var splitHiqus= function ( str ){ return str.split( sepHiqusRegexp ) } var splitPath= function ( str ){ var path= String( str ).split( sepPathRegexp ) for ( var j= path.length - 1; j >= 0; --j ) path[ j ]= decode( path[ j ] ) return path } var get= function ( ){ var obj= this for ( var i= 0, len= arguments.length; i < len; ++i ){ var name= arguments[ i ] if ( !name ) throw new Error( 'name is empty' ) obj= obj[ name ] if ( typeof obj !== 'object' ) return obj } return obj } var placin= function ( ){ var obj= this for ( var i= 0, len= arguments.length; i < len; ++i ){ var name= arguments[ i ] if ( name && Number( name ) != name ){ var o= obj[ name ] if (( !o )||( typeof o !== 'object' )) o= obj[ name ]= [] } else { var o= [] obj.push( o ) } obj= o } return obj } var put= function ( ){ var obj= this var len= arguments.length if ( !len ) return this var val= arguments[ len - 1 ] var key= arguments[ len - 2 ] if ( len > 2 ){ var path= [] for ( var i= len - 2; i-- ;) path[ i ]= arguments[ i ] obj= placin.apply( obj, path ) } if ( typeof val === 'object' ){ var v= ( len === 1 ) ? obj : placin.call( obj, key ) for ( var i in val ) if ( val.hasOwnProperty( i ) ) put.call( v, i, val[ i ] ) } else { val= String( val ) if ( !key || Number( key ) == key ) obj.push( val ) else obj[ key ]= val } return this } var parsin= function ( str ){ var chunks= splitHiqus( str ) for ( var i= 0, len= chunks.length; i < len; ++i ){ var path= chunks[i] if ( !path ) continue path= splitPath( path ) put.apply( this , path ) } return this } var serialize= function ( prefix, obj ){ if ( !obj ) return '' if ( typeof obj !== 'object' ){ if ( prefix === sepPathDefault ) prefix= '' return prefix+= encode( obj ) } var list= [] for ( var key in obj ) if ( obj.hasOwnProperty( key ) ){ var k= ( Number( key ) == key ) ? '' : encode( key ) var chunk= serialize( prefix + k + sepPathDefault, obj[ key ] ) if ( chunk ) list.push( chunk ) } return list.join( sepHiqusDefault ) } var Hiqus= function ( ){ var hiqus= ( this instanceof Hiqus ) ? this : new Hiqus var data= placin.call( hiqus, '_data' ) for ( var i= 0, len= arguments.length; i < len; ++i ){ var arg= arguments[i] if ( arg instanceof Hiqus ) arg= arg._data var invoke= ( Object( arg ) instanceof String ) ? parsin : put invoke.call( data, arg ) } return hiqus } Hiqus.prototype= new function (){ this .put= function (){ var hiqus= Hiqus( this ) put.apply( hiqus._data, arguments ) return hiqus } this .get= function ( ){ var val= get.apply( this ._data, arguments ) if ( typeof val === 'object' ) val= put.call( [], val ) return val } this .sub= function (){ var hiqus= Hiqus() var val= get.apply( this ._data, arguments ) if ( typeof val !== 'object' ) val= [ val ] hiqus._data= val return hiqus } this .toString = function (){ var str= serialize( '' , this ._data ) this .toString= function (){ return str } return str } } Export: return Hiqus Usage: alert( Hiqus ( Hiqus( '| a:b:c:1 / a:b: ; a:b::c & a=b__d' ) .sub( 'a' , 'b' ) .put( [ 'e' , 'f' ] ) , 'g/h' ) .get( 4 ) ) // alerts 'g' }

HiqusオブジェクトはImmutableパターンを実装し、コンストラクターを介して必要なデータを受け入れます。次のいずれかのタイプの任意の数のパラメーターを使用できます。

ひも解析されてツリーに追加されます。
Hiqusオブジェクト。そのデータはツリーに隣接します。
JSON Hiqusオブジェクトに似ています。

hiqusオブジェクトのメソッド：

put-元のコピーであるが、特定のパスに沿って指定された値を持つ新しいオブジェクトを返します。 Hiqus（）。Put（{user：{name： 'Nick'}}）はHiqus（）と同等です。Put（ 'user'、{name： 'Nick'}）とHiqus（）。Put（ 'user'、 'と同等です名前 '、' Nick '）
get-特定のパスの値のコピーを返します。 Hiqus（）。Get（ 'user'、 'name'）は不確実性を返し、Hiqus（ 'Nick; John'）。Get（）は['Nick'、 'John']を返します
sub-特定のパスの値に基づいて新しいオブジェクトを作成します。 Hiqus（ 'users :: Nick | users :: John'）。Sub（ 'users'）はHiqus（ 'Nick; John'）と同等です
toString-スラッシュと等号を区切り文字として使用して文字列に変換します。シリアル化の結果はキャッシュされます。

テスト

;( function ( x, y ){ if ( '' + x == y ) return arguments.callee console.log( x, y ) throw new Error( 'fail test: [ ' + x + ' ]!=[ ' + y + ' ]' ) }) ( Hiqus( ), '' ) ( Hiqus( {} ), '' ) ( Hiqus( [] ), '' ) ( Hiqus( [1] ), '1' ) ( Hiqus( { '' :1} ), '1' ) ( Hiqus( { '' :{ '' :1}} ), '==1' ) ( Hiqus( [1,2] ), '1/2' ) ( Hiqus( {1:2} ), '2' ) ( Hiqus( {a:1} ), 'a=1' ) ( Hiqus( { 'a_b' :1} ), 'a%5Fb=1' ) ( Hiqus( {a:{b:1}} ), 'a=b=1' ) ( Hiqus( {a:1,b:2} ), 'a=1/b=2' ) ( Hiqus( {a:1},{b:2} ), 'a=1/b=2' ) ( Hiqus( {a:1}, 'b:2' ), 'a=1/b=2' ) ( Hiqus( {a:1},{b:2} ), new Hiqus( {a:1},{b:2} ) ) ( Hiqus( Hiqus({a:1}), Hiqus({b:2}) ), 'a=1/b=2' ) ( Hiqus( '' ), '' ) ( Hiqus( 'a' ), 'a' ) ( Hiqus( '=a' ), 'a' ) ( Hiqus( '==1' ), '==1' ) ( Hiqus( 'a=1' ), 'a=1' ) ( Hiqus( 'a:1' ), 'a=1' ) ( Hiqus( 'a_1' ), 'a=1' ) ( Hiqus( 'a=b=1' ), 'a=b=1' ) ( Hiqus( 'a=1/b=2' ), 'a=1/b=2' ) ( Hiqus( 'a=1;b=2' ), 'a=1/b=2' ) ( Hiqus( 'a=1 b=2' ), 'a=1/b=2' ) ( Hiqus( 'a=1&b=2' ), 'a=1/b=2' ) ( Hiqus( 'a=1|b=2' ), 'a=1/b=2' ) ( Hiqus( '1/2' ).get(), '1,2' ) ( Hiqus( 'a=1/b=2' ).get( 'a' ), '1' ) ( Hiqus( 'a=1=2/b=2=3' ).get( 'b' ,'0'), '3' ) ( ( ( a= Hiqus( 'a=1/b=2' ) ).get( 'a' ), a ), 'a=1/b=2' ) ( Hiqus( 'a=1/b=2' ).sub(), 'a=1/b=2' ) ( Hiqus( 'a=b=1/a=c=2/d=3' ).sub( 'a' ), 'b=1/c=2' ) ( Hiqus( 'a=b==1/a=b==2' ).sub( 'a' , 'b' ), '1/2' ) ( ( a= Hiqus( 'a=1/b=2' ) ).sub( 'a' ) && a, 'a=1/b=2' ) ( Hiqus( 'a=1' ).put( {b:2} ), 'a=1/b=2' ) ( Hiqus( 'a=1' ).put( 'a' , {b:2} ), 'a=b=2' ) ( ( a= Hiqus( 'a=1' ) ).put( 'b=2' ) && a, 'a=1' ) ;

Hiqus-ヒエラリカルクエリストリング

説明

例

JavaScriptリファレンス実装

テスト

More articles: