Criando Ligações de Dados Customizados

O adaptador fornece uma opção para criar ligações de dados customizados para atender às necessidades do ambiente. Uma ligação de dados customizados é uma classe Java que você grava para converter um fluxo de dados para um objeto de negócios durante o processamento de entrada e um objeto de negócios para um fluxo de dados durante o processamento de saída. O EIS (Enterprise Information System) e as exportações e importações JMS podem ser configuradas para chamar ligações de dados customizados.

Sobre Esta Tarefa

As etapas a seguir o orientam pelo processo de criação de ligações de dados customizados.

Como Executar Esta Tarefa

  1. Implemente a ligação de dados customizados utilizando a interface commonj.connector.runtime.RecordHolderDataBinding. Esta interface está localizada no arquivo commonj.connector.jar, que está contido nas bibliotecas do tempo de execução do WebSphere Process Server.
  2. Crie as ligações de dados customizados utilizando as informações de entrada ou de saída mostradas abaixo.
    • Para converter um fluxo de dados para um objeto de negócios para processamento de entrada, o adaptador chama os métodos public void setRecord(Record arg0) e public DataObject getDataObject() da ligação de dados customizados. Primeiro chama setRecord e, em seguida, chama getDataObject.
      1. O método setRecord utiliza com.ibm.j2ca.base.UnstructuredRecord como um parâmetro. Essa classe faz parte do arquivo jar da classe de Fundação do Adaptador. O registro do objeto de negócios, como texto ou byte[], é enviado à ligação de dados customizados neste método. Outras informações requeridas também são enviadas.
      2. O getDataObject() obtém o registro do objeto de negócios, configurado como mencionado acima, efetua a transformação de dados necessária e retorna o objeto de negócios requerido.
      3. O getRecordName() presente no registro não estruturado obtém o espaço de nomes completo com o qual é possível instanciar o objeto de negócios e extrair (conforme mencionado na etapa 3) qualquer ASI presente na anotação. Esse ASI é utilizado pela ligação de dados. Por exemplo:

        recordName = http://www.ibm.com/xmlns/prod/websphere/j2ca/ftp/customerwrapperbg/CustomerWrapperBG

        namespace = http://www.ibm.com/xmlns/prod/websphere/j2ca/ftp/customerwrapperbg

        object name = CustomerWrapperBG

    • Para converter um objeto de negócios para um fluxo de dados para processamento de saída, o adaptador chama os métodos public void setDataObject(DataObject dataObject) e public Record getRecord() da ligação de dados customizados. Primeiro chama setDataObject e, em seguida, chama getRecord.
      1. O método setDataObject utiliza o objeto de negócios como um parâmetro. A saída de getRecord deve ser do tipo com.ibm.j2ca.base.UnstructuredRecord.
      2. Informações específicas do aplicativo são obtidas do objeto de negócios de entrada, conforme mencionado na etapa 3.
      3. O método getRecord efetua a transformação necessária e retorna os dados nativos no formato de um registro não estruturado.

    Um exemplo de dados nativos EIS com texto delimitado é: Employee~Create~sarath~IBM~Bangalore~560071

    Esquema do objeto de negócios:
    complexType name="Employee"
    			sequence maxOccurs="1" minOccurs="1"
    				element maxOccurs="1" minOccurs="0" name="name" type="string"/
    				element maxOccurs="1" minOccurs="0" name="company" type="string"/
    				element maxOccurs="1" minOccurs="0" name="city" type="string"/
    				element maxOccurs="1" minOccurs="0" name="zip" type="string"/
    			/sequence
    		/complexType
  3. Para acessar informações específicas do aplicativos na anotação do objeto de negócios, utilize o arquivo CWYBS_AdapterFoundation.jar, que contém uma classe denominada com.ibm.j2ca.base.AdapterBOUtil. Essa classe contém o método para extrair as informações específicas do aplicativo do objeto de negócios.
  4. Utilize a API (Interface de Programação de Aplicativo) do objeto de negócios para extrair cada valor contido na anotação. A saída é um objeto de negócios que representa as informações específicas do aplicativo.
    • Para a entrada, instancie o objeto de negócios a partir do valor recordName contido no registro não estruturado.
    • Para a saída, chame getMetadataForObject() transmitindo o objeto de negócios como um parâmetro.

O que Fazer a Seguir

Configure as ligações dos dados customizados utilizando as instruções detalhadas localizadas em WPS_install_directory\samples\doc\CustomEISDataBinding\index.html.

Termos de Utilização |


(c) Copyright IBM Corporation 2005, 2006.
Este centro de informações é desenvolvido com a tecnologia Eclipse (http://www.eclipse.org)