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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Informações específicas do aplicativo são obtidas do objeto de negócios de entrada, conforme mencionado na etapa 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
- 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.
- 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.