L�ngua de pergunta de XAM

Assim como o fornecimento de meios vendedor-independentes da cria��o, recuperando, modificando e suprimindo de XSets, a especifica��o de SNIA XAM v1.0 igualmente define uma l�ngua de pergunta (XAM QL), baseada em um subconjunto da l�ngua do SQL, porque de selecionar e de recuperar o XUIDs de XSets baseado em crit�rios �ndice-definidos.

O jogo de palavras reservados para esta l�ngua de pergunta � completamente pequeno: selecione, onde, e, ou, n�o, como, existe, liga��o, de leitura apenas, typeof, comprimento, data, VERDADEIROS, FALSOS, antes que, ap�s, contenha, e dentro. Pelo projeto, as perguntas de XAM olham como uma indica��o seleta do SQL. A l�ngua de pergunta � n�o diferenciando mai�sculas e min�sculas e usa o jogo de caracteres de ASCII.

Est� aqui um exemplo de uma pergunta simples de XAM:

select ".xset.xuid" where "com.example.name" = ’Tuckers Plantation'

A vers�o 1.0 da especifica��o de XAM define dois n�veis de sustenta��o da l�ngua de pergunta, o n�vel 1 isto � do n�vel 1 e do n�vel 2. define perguntas em propriedades e atributos de campo em XSets e � imperativo. Todo o valor dos bens im�veis de XSet que for acess�vel a um programa de aplica��o atrav�s da biblioteca de XAM pode ser perguntado. O n�vel 2 estende o n�vel 1 �s perguntas da sustenta��o em XStreams e � opcional. Ambos os n�veis de pergunta s�o alcan�ados atrav�s de um �nico, tipo definido do trabalho que todos os fornecedores de XAM devam suportar. Desde que nenhum vendedor que eu estou ciente de tem perguntas do n�vel realmente executado 2, o restante de focos deste borne em perguntas do n�vel 1.

Uma indica��o de pergunta de XAM consiste em uma cl�usula seleta imperativa seguida por um opcional onde cl�usula. Para XAM v1.0 a �nica cl�usula seleta v�lida � o `seleto .xset.xuid'. Isto especific que a aplica��o est� pedindo uma lista de valores de XUID. Por exemplo

select ".xset.xuid "

retornar� uma lista de cada XSet que � leg�vel na altura da pergunta.

Onde a cl�usula � usada para especific um subconjunto de XSets a ser combinado. Para perguntas do n�vel 1 � restringida �s compara��es entre propriedades de XSet e valores e/ou atributos de campo literais e valores literais.

select ".xset.xuid" where ".xam.time.xuid" > date(’2009-02-01T00:00:00.0’)

retornar� a lista de todo o Xsets em que foram criados ou ap�s fevereiro � 2009.

As seguintes mostras da tabela que colocam e os tipos literais podem v�lida ser comparados.

As seq��ncias de escape suportadas s�o as seguintes. Toda a outra seq��ncia de escape gerar� um erro non-fatal.

select ".xset.xuid" where "com.example.string-property" = ’This is a string literal’

Para usar umas �nicas cita��es em uma corda, guarde-a com um backslash

select ".xset.xuid" where "com.example.claimed.ownership" = ’Tucker\’s’

Todos os exemplos de nomes de campo em uma corda da pergunta de XAM devem ser citados com cita��es dobro. Se um nome de campo contem car�teres das cita��es dobro, cada car�ter das cita��es dobro deve ser escapado usando um backslash. Por exemplo, o nome de campo para a propriedade xam_boolean com.example. qstring deve ser representado em uma pergunta como

select ".xam.xuid" where "com.example.\"qstring\"" = TRUE

Se um nome de campo contem um car�ter do backslash, o backslash pr�prio deve ser escapado com um outro backslash. Por exemplo, o nome de campo para a propriedade xam_double com.example.file \ rela��o deve ser representado em uma pergunta como

select ".xam.xuid" where "com.example.file\\ratio" = 100.1

A l�ngua de pergunta aceita o date-time e os literals XUID-avaliados que usam as fun��es do seletor datam () e xuid () respectivamente. A fun��o da data () toma um valor corretamente dado forma do date-time, especific porque uma corda literal que seja consistente com a especifica��o do date-time de XAM.

select ".xset.xuid" where ".xam.time.xuid" = date(’2009-06-01T00:00:00.0’)

A fun��o do xuid () espera um XUID que seja sob a forma de um literal de corda codificado base64. Um literal de corda impropriamente dado forma gera um erro non-fatal durante a an�lise gramatical da pergunta.

Os atributos de campo s�o utiliza��o alcan�ada existem, typeof, de leitura apenas, emperramento, e fun��es do accessor do atributo de campo do comprimento. Existem () os testes de fun��o para a exist�ncia de um atributo de campo nomeado (propriedade) em um XSet. Avalia PARA RECTIFICAR se um XSet contem o campo nomeado de outra maneira que avalia FALSO.

select ".xset.xuid" where exists("com.example.name")

A fun��o do typeof () retorna o tipo do MIME de um campo nomeado em um XSet que seja uma propriedade corda-avaliada.

select ".xset.xuid" where typeof("com.example.data") = ’text/plain’
select ".xset.xuid" where typeof("com.example.data") like ’text%’

Esta fun��o pode ser usada sempre que uma aplica��o poderia usar uma refer�ncia do campo a uma propriedade corda-avaliada. Anote que as compara��es com todo o valor literal da n�o-corda geram um erro non-fatal durante a an�lise gramatical da pergunta.

() A fun��o de leitura apenas avalia PARA RECTIFICAR quando um campo em um XSet � marcado como de leitura apenas.

select ".xset.xuid" where readonly("com.example.flag")
select ".xset.xuid" where not readonly("com.example.name")

() A fun��o obrigat�ria avalia PARA RECTIFICAR quando um campo em um XSet � marcado como ligando.

select ".xset.xuid" where binding("com.example.case_id")
select ".xset.xuid" where not binding("com.example.subject")

A fun��o do comprimento () retorna o comprimento, nos bytes, de um campo nomeado.

select ".xset.xuid" where length("com.example.data") > 1024

Quando usado na propriedade coloca retornos desta fun��o o comprimento como definido para stypes. Anote que esta fun��o n�o deve ser usada para comparar o n�mero de car�teres em uma corda enquanto esta compara��o depende da codifica��o do car�ter que est� sendo usada.

Giro agora para operadores l�gicos. Subclauses dentro do onde a cl�usula pode ser combinada e modificado usando os operadores l�gicos e, ou e n�o. Estes operadores s�o similares a suas contrapartes do SQL.

E operador exige ambos os subclauses avaliar PARA RECTIFICAR antes de incluir um XSet nos resultados. Por exemplo

select ".xset.xuid" where typeof("com.example.stream") = ’image/gif’ and length("com.example.stream") > 4096

seleciona somente aquele XSets que contem as imagens do GIF cujo o tamanho � maior de 4096 bytes. Ou operador avalia PARA RECTIFICAR se um ou outro subclause avalia PARA RECTIFICAR. Por exemplo

select ".xset.xuid" where typeof("com.example.stream") = ’image/jpeg’ or typeof("com.example.stream") = ’image/gif’

seleciona somente aquele XSets que contem um c�rrego nomeado do tipo JPEG ou GIF da imagem. N�o o operador nega uma express�o booleana. Por exemplo

select ".xset.xuid" where not binding("com.example.property")

seleciona todo o XSets com a propriedade nonbinding com.example.property.

Como em determinados operadores do SQL tome a preced�ncia sobre outros operadores nas perguntas. A preced�ncia de operador de XAM QL � como segue:

select ".xset.xuid" where not "com.example.bool-prop" and  "com.example.int-prop" = 64
select ".xset.xuid" where not ("com.example.bool-prop" and "com.example.int-prop" = 64)

No primeiro exemplo, n�o o operador aplica-se somente � propriedade de com.example.bool-prop. No segundo exemplo, n�o o operador aplica-se a com.example.bool-prop e a com.example.int-prop = 42.

Agora que n�s somos um tanto familiares com a sintaxe de XAM QL, a pergunta seguinte a ser respondida � como n�s dizemos um sistema do armazenamento de XAM para executar uma pergunta e para nos retornar os resultados. Bem despeja que uma pergunta est� executada como um tipo particular de trabalho de XAM chamou um trabalho da pergunta. A entrada a um trabalho da pergunta � um XSet que voc� deva criar. Este XSet deve conter dois artigos - o mand de org.snia.xam.job.com do campo que � ajustado sempre ao `xam.job.query e a um mand de XStream xam.job.query.com que seja um c�rrego de texto UTF-8 (tipo texto do MIME do `/liso; charset=utf-8') contendo a corda real da express�o da pergunta.

Um trabalho da pergunta pode opcionalmente ser cometido antes ou durante da execu��o do trabalho, mas este comete n�o � exigido. A habilidade de cometer um trabalho running � dependente opcional e da execu��o. Uma aplica��o pode determinar se o trabalho comete � suportado verific a propriedade booleana .xsystem.job.com mit.supported de XSystem. A falha cometer um trabalho da pergunta antes de fechar o XSet significa que os resultados do trabalho da pergunta n�o est�o armazenados persistente.

Um trabalho da pergunta � executado invocando o submitJob. Se qualquer um dos dois artigos exigidos no trabalho XSet da pergunta n�o � preenchido corretamente, o campo padr�o .xam.job.error do erro do trabalho est� adicionado ao trabalho XSet da pergunta e � valor � ajustado a um ou outro org.snia.xam:: not_a_job ou org.snia.xam:: o unspecified_command e o trabalho da pergunta s�o abortados. Segundo as indica��es da aplica��o de amostra abaixo, o estado de um trabalho da pergunta pode ser determinado examinando o valor de .xam.job.status.

Quando um trabalho da pergunta � bem sucedido, os resultados est�o armazenados no trabalho XSet da pergunta sob a forma de um XStream novo nomeado xam.job.query.results. Este XStream tem um tipo do MIME da aplica��o/vnd.snia.xam.query.xuid_list e contem o XUIDs para o jogo de XSets resultando da avalia��o da pergunta. Cada XUID � armazenado em um formato bin�rio como parte de um registro de 80 bytes. Se um XUID � mais curto de 80 bytes, o registro � zero acolchoado a 80 bytes.

Um n�mero outras de propriedades em rela��o aos resultados XStream igualmente setup. A propriedade xam.job.query.results.count do xam_int contem a contagem atual dos registros de XUID nos resultados XStream. Esta propriedade � actualizado porque os resultados s�o incorporados nos resultados XStream durante o processamento da pergunta. Uma aplica��o pode usar esta para fornecer a informa��o de status aos usu�rios enquanto o trabalho da pergunta executa. A propriedade xam_string xam.job.query.level indica o n�vel da pergunta que combina os resultados. Seu valor � org.snia.xam.job.query.level.1 ou org.snia.xam.job.query.level.2.

� importante recordar que um trabalho da pergunta se opera dentro dos pap�is e das permiss�es concedidos � conex�o. Isso significa que os resultados XStream incluem somente aquele XSets que s�o vis�veis e acess�veis a uma aplica��o, pelo menos de uma perspectiva lida, de acordo com o papel sob que o trabalho da pergunta � executado.

O trabalho da pergunta pode ajustar os seguintes c�digos de erro em .xam.job.error:

Anote que, ao contr�rio de um RDBMS tradicional, n�o h� nenhum travamento de um sistema do armazenamento de XAM durante a execu��o de um trabalho da pergunta. Assim um resultado da pergunta n�o � um instant�neo instant�neo de um sistema do armazenamento de XAM. Os �ndices de um sistema do armazenamento de XAM podem ou n�o podem mudar quando um trabalho da pergunta for executado. A r�gua geral � que nenhum XSet que estiver armazenado antes que o come�o do trabalho da pergunta esteja inclu�do nos resultados XStream se encontra os crit�rios da pergunta, e nenhum XSet que for armazenado depois que o trabalho da pergunta terminou n�o devem ser inclu�dos nos resultados XStream. XSets que � armazenado durante a execu��o de trabalho da pergunta pode ou n�o pode ser inclu�do. Os mesmos crit�rios aplicam-se aos resultados XStream. Pode incluir XUIDs de XSets que est� j� n�o no sistema do armazenamento de XAM e no XUIDs de XSets que j� n�o encontra os crit�rios de busca devido a uma mudan�a no XSet depois que o detalhe XSet foi perguntado.

Est� aqui uma aplica��o de Java simples que pergunte um sistema do armazenamento de XAM para o determinar seja n�vel de sustenta��o para perguntas de XAM.

import org.snia.xam.XAMException;
import org.snia.xam.XAMLibrary;
import org.snia.xam.XSystem;
import org.snia.xam.toolkit.XAMXUID;
import org.snia.xam.util.XAMLibraryFactory;

public class CheckQuerySupport
{
    private static XAMLibrary xamLib;
    private static XSystem xSystem;

    public static void main(String[] args)
    {
        String xri = "snia-xam://centera_vim!XXX.XXXX.XXX.XXX?/home/fpm/xam/xamconnect.pea";

        long exitCode = 0;
        boolean isSupported = false;

        try
        {
            xamLib = XAMLibraryFactory.newXAMLibrary();
            System.out.println("Connecting to XSystem: " + xri + "\n");

            xSystem = xamLib.connect(xri);

            // support job commit?
            isSupported = xSystem.getBoolean(XSystem.XAM_XSYSTEM_JOB_COMMIT_SUPPORTED);
            System.out.println("Support job commit? " + (isSupported ? "Yes" : "No"));

            // support continuance of job?
            isSupported = xSystem.getBoolean(XSystem.XAM_XSYSTEM_JOB_QUERY_CONTINUANCE_SUPPORTED);
            System.out.println("Support job continuance? " + (isSupported ? "Yes" : "No"));

            // support level 1 query?
            isSupported = xSystem.getBoolean(XSystem.XAM_XSYSTEM_JOB_QUERY_LEVEL1_SUPPORTED);
            System.out.println("Support level 1 query? " + (isSupported ? "Yes" : "No"));

            // support level 2 query?
            isSupported = xSystem.getBoolean(XSystem.XAM_XSYSTEM_JOB_QUERY_LEVEL2_SUPPORTED);
            System.out.println("Support level 2 query? " + (isSupported ? "Yes" : "No"));

            xSystem.close();
            System.out.println("\nClosed connection to XSystem");

        } catch (XAMException xe) {
            exitCode = xe.getStatusCode();
            System.err.println("XAM Error occured: " + xe.getMessage());
        } catch (IllegalArgumentException e) {
            System.out.println(e.getMessage());
            e.printStackTrace();
            exitCode = 1;
        }

        System.exit((int) exitCode);
    }
}

Est� aqui a sa�da desta aplica��o quando conectada a um sistema do armazenamento da compatibilidade electr�nica Centera XAM

Connecting to XSystem: snia-xam://centera_vim!XXX.XXX.XXX.XXX?/home/fpm/xam/xamconnect.pea

Support job commit? No
Support job continuance? No
Support level 1 query? Yes
Support level 2 query? No

Closed connection to XSystem

Est� aqui uma aplica��o de Java mais longa que execute tr�s a amostra XSets e as perguntas da amostra que s�o discutidos na se��o 10.8 do original da arquitetura V1.0 de XAM.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;

import org.snia.xam.XAMException;
import org.snia.xam.XAMLibrary;
import org.snia.xam.XSet;
import org.snia.xam.XStream;
import org.snia.xam.XSystem;
import org.snia.xam.XUID;
import org.snia.xam.toolkit.XAMXUID;
import org.snia.xam.util.XAMLibraryFactory;

public class QueryExample
{
    private static XAMLibrary xamLib;
    private static XSystem xSystem;

    private static void CreateXset(int parm1, String parm2, double parm3)
             throws XAMException
    {
        System.out.print("Create XSet 1 ....  ");

        XSet xSet = xSystem.createXSet(XSet.MODE_UNRESTRICTED);
        xSet.createProperty("com.example.rhc", false, true);
        xSet.createProperty("com,example.foo", false, parm1);
        xSet.createProperty("com.example.bar", false, parm2);
        xSet.createProperty("com.example.num", false, parm3);

        XUID xuID = xSet.commit();
        System.out.println("XUID: " + xuID.toString());

        xSet.close();
    }

   private static void CreateXset(int parm1, int parm2, int parm3)
             throws XAMException
    {
        System.out.print("Create XSet 2 ....  ");

        XSet xSet = xSystem.createXSet(XSet.MODE_UNRESTRICTED);
        xSet.createProperty("com.example.rhc", false, true);
        xSet.createProperty("com,example.foo", false, parm1);
        xSet.createProperty("com.example.bar", false, parm2);
        xSet.createProperty("com.example.num", false, parm3);

        XUID xuID = xSet.commit();
        System.out.println("XUID: " + xuID.toString());

        xSet.close();
    }

    private static void CreateXset(int parm1, int parm2)
             throws XAMException
    {
        System.out.print("Create XSet 3 ....  ");

        XSet xSet = xSystem.createXSet(XSet.MODE_UNRESTRICTED);
        xSet.createProperty("com.example.rhc", false, true);
        xSet.createProperty("com,example.foo", false, parm1);
        xSet.createProperty("com.example.num", false, parm2);

        XUID xuID = xSet.commit();
        System.out.println("XUID: " + xuID.toString());

        xSet.close();
    }

    private static void QueryXsystem(String queryString)
            throws XAMException
    {
        boolean finished = false;
        final int XAM_MAX_XUID = 80;
        int resultCount = 0;
        String status;

        System.out.println("Create query XSet. Query string: " + queryString);

        XSet query = xSystem.createXSet(XSet.MODE_UNRESTRICTED);
        query.createProperty(XSet.XAM_JOB_COMMAND, true, XSet.XAM_JOB_QUERY);

        byte[] buffer = queryString.getBytes();
        XStream queryStream = query.createXStream(XSet.XAM_JOB_QUERY_COMMAND, true, XAMLibrary.TEXT_PLAIN_MIME_TYPE);
        queryStream.write(buffer);
        queryStream.close();

        System.out.println("Submit query job ....");
        query.submitJob();

        System.out.println("Wait for query job to finish ....");

        while (!finished)
        {
            // check  status of query job
            status = query.getString(XSet.XAM_JOB_ERRORHEALTH);
            if (status.equals(XSet.XAM_JOB_ERRORHEALTH_ERROR))
            {
                System.out.println("ERROR: Errorhealth - " + query.getString(XSet.XAM_JOB_ERROR));
                query.haltJob();
                System.out.println("ERROR: Job halted");
                break;
            }

            status = query.getString(XSet.XAM_JOB_STATUS);
            resultCount = (int) query.getLong(XSet.XAM_JOB_QUERY_RESULTS_COUNT);

            // uncomment if you want continuous job status
            // System.out.println("Job Status: " + status + "  Result count: " + resultCount);

            // exit loop if job complete
            if (status.equals(XSet.XAM_JOB_STATUS_COMPLETE))
            {
                finished = true;
            }
       }

        System.out.println("Query job completed ....");
        System.out.println("Result set final count is: " + resultCount);

        if (resultCount > 0)
        {
             // open query job result stream
             XStream results = query.openXStream(XSet.XAM_JOB_QUERY_RESULTS, XStream.MODE_READ_ONLY);

             byte rawXUID[] = new byte[XAM_MAX_XUID];
             long bytesRead = 0;

             // output XUIDs in result set
             while( (bytesRead = results.read(rawXUID, XAM_MAX_XUID)) >= 0 )
             {
                 XAMXUID resultXUID = new XAMXUID(rawXUID);
                 System.out.println("XUID: " + resultXUID.toString());
             }

             results.close();
        }

        query.close();
    }

    public static void main(String[] args)
    {
        String xri = "snia-xam://centera_vim!XXX.XXX.XXX.XXX?/home/fpm/xam/xamconnect.pea";
        long exitCode = 0;

        try
        {
            xamLib = XAMLibraryFactory.newXAMLibrary();

            // uncomment next 2 lines if you want extensive XAM Library logging
            // xamLib.setProperty(XAMLibrary.XAM_LOG_VERBOSITY, 1);
            // xamLib.setProperty(XAMLibrary.XAM_LOG_LEVEL, 5);

            System.out.println("Connecting to XSystem " +  xri + "\n");

            xSystem = xamLib.connect(xri);
            xSystem.setProperty(".xsystem.log.verbosity", 1);
            xSystem.setProperty(".xsystem.log.level", 5);

            CreateXset(1, "string", 123.55);
            CreateXset(77, 42, 100);
            CreateXset(6, 200);

            xSystem.close();

            System.out.println("\nClose/reopen XSystem\n");

            xSystem = xamLib.connect(xri);

            // uncomment one or more of the following queries
            // QueryXsystem("select \".xset.xuid\"");
            QueryXsystem("select \".xset.xuid\" where (\"com.example.foo\" > 0) and (\"com.example.foo\" < 50)");
            // QueryXsystem("select \".xset.xuid\" where (\"com.example.bar\" > 0) and (\"com.example.bar\" < 100)");
            // QueryXsystem("select \".xset.xuid\" where exists (\"com.example.bar\")");
            // QueryXsystem("select \".xset.xuid\" where \"com.example.bar\" like '%ing%'");
            // QueryXsystem("select \".xset.xuid\" where \"com.example.num\" >= 124");
            // QueryXsystem("select \".xset.xuid\" where \"com.example.num\" >= 124.6 ");
            // QueryXsystem("select \".xset.xuid\" where (\"com.example.num\" >= 123) and typeof(\"com.example.num\") = 'application/vnd.snia.xam.int'");

            xSystem.close();
            System.out.println("\nClosed connection to XSystem");

        } catch (XAMException xe) {
            exitCode = xe.getStatusCode();
            System.err.println("XAM Error occured: " + xe.getMessage() + "("
                    + exitCode + ")");
        } catch (IllegalArgumentException e) {
            System.out.println(e.getMessage());
            e.printStackTrace();
            exitCode = -1;
        }

        System.exit((int) exitCode);
    }
}

Anote que os resultados XStream produzido por um trabalho da pergunta podem ser consumidos por uma aplica��o antes que o sistema do armazenamento de XAM termine armazenar todo o XUIDs nos resultados XStream se XStream.asyncRead est� usado em vez de XStream.read.

Bem eu penso que eu forneci bastante informa��o e exemplos para o permitir de ir jogo com a l�ngua de pergunta de XAM por o senhor mesmo. Voc� precisa a ajuda mim � certa que o grupo do colaborador de XAM em grupos de Google ser� mais do que feliz o ajudar.

Na divis�o eu indic que desde que os fornecedores do sistema do armazenamento de XAM s�o exigidos atualmente somente executar a sustenta��o para perguntas sobre os metadata satisfeitos, eu suspeito que a sustenta��o para as buscas completamente �ndice-baseadas reais que usam XAM n�o pode ocorrer por alguma hora.