Use o fragmento de código de amostra e os gráficos de dados para criar uma entidade em uma hierarquia e obter os descendentes e os ancestrais de uma entidade usando o método get().
O fragmento de código de amostra e os gráficos de dados incluem as seguintes etapas:
Assegure-se de ter lido as informações e concluído as etapas descritas no tópico Pré-requisitos de Programação.
Inclua o seguinte fragmento de código no código do aplicativo e substitua as variáveis pelos valores reais que você deseja usar.
/**
* testDescendantsAndAncestorsSnippet faz o seguinte:
* Cria uma hierarquia OrgContainer na região padrão
* Cria usuários filhos dessa hierarquia OrgContainer
* Obtém os descendentes da entidade pai
* Obtém o ancestral da entidade filha
*/
public static void testDescendantsAndAncestorsSnippet()
{
//Criar entidade do tipo OrgContainer
DataObject rt = addOrgContainer("cn", "users", null);
// Criar sub-entidade em cn=users
DataObject rt1 = addOrgContainer("o", "SWG", rt);
// Criar sub-entidade em o=SWG,cn=users
DataObject rt2 = addOrgContainer("ou", "India", rt1);
//Recuperar a entidade pai para os usuários que forem criados a seguir
DataObject parentEntity = (DataObject) rt2.getList(SchemaConstants.DO_ENTITIES).get(0);
//Incluir dois usuários, user1 e user2
DataObject usr1 = addPersonAccountWithNonDefaultParent("user1","user1cn","user1sn",parentEntity);
DataObject usr2 = addPersonAccountWithNonDefaultParent("user2","user2cn","user2sn",parentEntity);
//Obter os descendentes
getDescendant();
//Obter os ancestrais de user1
getAncestor(usr1);
}
/**
* addOrgContainer inclui uma entrada no determinado pai
* @param prefixo é o rdnProperty
* @param valor é os valores de rdnProperty
* @param obj é o dataObject do qual o pai é identificado
* @return DataObject
*/
public static DataObject addOrgContainer (String prefix, String value, DataObject obj)
{
DataObject parentEntity;
boolean first = false;
try
{
if (obj == null) {
obj = SDOHelper.createRootDataObject();
first = true;
}
DataObject entity = SDOHelper.createEntityDataObject(obj, null, SchemaConstants.DO_ORGCONTAINER);
if (!first) {
// Configurar o pai da entidade OrgContainer
parentEntity = (DataObject) obj.getList(SchemaConstants.DO_ENTITIES).get(0);
entity.set("parent",parentEntity);
}
// Configurar a propriedade OrgContainer
entity.set(prefix, value);
System.out.println("Gráfico de dados de entrada antes de criar OrgContainer"+ printDO(obj));
// Criar a entidade OrgContainer
obj = service.create(obj);
System.out.println("Gráfico de dados de saída depois de criar OrgContainer"+ printDO(obj));
}
catch(Exception e)
{
e.printStackTrace();
}
return obj;
}
/**
* addPersonAccountWithNonDefaultParent
* Inclui uma entidade do tipo PersonAccount sob o pai especificado
* @param uid valor a ser configurado
* @param cn valor a ser configurado
* @param sn valor a ser configurado
* @param parent valor a ser configurado
* @return DataObject
*/
public static DataObject addPersonAccountWithNonDefaultParent(String uid, String cn, String sn, DataObject parent)
{
DataObject root = null;
try
{
root = SDOHelper.createRootDataObject();
DataObject entity = SDOHelper.createEntityDataObject(root, null, SchemaConstants.DO_PERSON_ACCOUNT);
// Configurar as propriedades da entidade
entity.set("uid", uid);
entity.set("cn", cn);
entity.set("sn", sn);
entity.set("parent", parent);
System.out.println("Gráfico de dados de entrada antes de criar o usuário"+ printDO(root));
// Criar a entidade PersonAccount
root = service.create(root);
System.out.println("Gráfico de dados de saída depois de criar o usuário"+ printDO(root));
}
catch(Exception e)
{
e.printStackTrace();
}
return root;
}
/**
* getDescendant recupera as entidades descendentes de uma entidade
*/
public static void getDescendant()
{
try
{
DataObject root = SDOHelper.createRootDataObject();
DataObject entity = SDOHelper.createEntityDataObject(root, null, SchemaConstants.DO_ENTITY);
//Configurar o nome exclusivo da entidade cujos descendentes precisam ser encontrados
entity.createDataObject(SchemaConstants.DO_IDENTIFIER).setString(SchemaConstants.PROP_UNIQUE_NAME,
"cn=users,o=defaultWIMFileBasedRealm");
//Criar o objeto de controle descendente
DataObject descCtrl = SDOHelper.createControlDataObject(root, null,
SchemaConstants.DO_DESCENDANT_CONTROL);
// Configurar o nível de propriedade para recuperar todos os descendentes aninhados
descCtrl.setInt(SchemaConstants.PROP_LEVEL, SchemaConstants.PROP_LEVEL_NESTED);
// Configurar as propriedades que precisam ser recuperadas dos descendentes
descCtrl.getList(SchemaConstants.PROP_PROPERTIES).add("uid");
descCtrl.getList(SchemaConstants.PROP_PROPERTIES).add("o");
descCtrl.getList(SchemaConstants.PROP_PROPERTIES).add("ou");
System.out.println("Gráfico de dados de entrada antes de obter descendentes"+ printDO(root));
// Obter as entidades
root = service.get(root);
System.out.println("Gráfico de dados de saída depois de obter descendentes"+ printDO(root));
}
catch(Exception e)
{
e.printStackTrace();
}
}
/**
* getAncestor recupera as entidades ancestrais de uma entidade
* @param entity Nome da entidade cujo ancestral precisa ser recuperado
*/
public static void getAncestor(DataObject entity)
{
try
{
// Configurar o objeto de controle ancestral
DataObject ancesCtrl = SDOHelper.createControlDataObject(entity, null,
SchemaConstants.DO_ANCESTOR_CONTROL);
// Configurar o nível de propriedade para recuperar todos os ancestrais aninhados
ancesCtrl.setInt(SchemaConstants.PROP_LEVEL, SchemaConstants.PROP_LEVEL_NESTED);
// Configurar as propriedades que precisam ser recuperadas dos ancestrais
ancesCtrl.getList(SchemaConstants.PROP_PROPERTIES).add("cn");
ancesCtrl.getList(SchemaConstants.PROP_PROPERTIES).add("o");
ancesCtrl.getList(SchemaConstants.PROP_PROPERTIES).add("ou");
System.out.println("Gráfico de dados de entrada antes de obter ancestrais"+ printDO(entity));
// Obter as entidades
entity = service.get(entity);
System.out.println("Gráfico de dados de saída depois de obter ancestrais"+ printDO(entity));
}
catch(Exception e)
{
e.printStackTrace();
}
}
Gráfico de dados de entrada para criar uma entidade pai, OrgContainer, cn:
<?xml version="1.0" encoding="UTF-8"?>
<sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sdo="commonj.sdo" xmlns:wim="http://www.ibm.com/websphere/wim">
<wim:Root>
<wim:entities xsi:type="wim:OrgContainer">
<wim:cn>users</wim:cn>
</wim:entities>
</wim:Root>
</sdo:datagraph>
Gráfico de dados de saída depois de criar uma entidade pai, OrgContainer, cn:
<?xml version="1.0" encoding="UTF-8"?>
<sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sdo="commonj.sdo" xmlns:wim="http://www.ibm.com/websphere/wim">
<wim:Root>
<wim:entities xsi:type="wim:OrgContainer">
<wim:identifier externalName="cn=users,o=defaultWIMFileBasedRealm" repositoryId="InternalFileRepository"
uniqueId="ecf1d16b-9ab8-4de6-a2a5-7eb48fd2fe7c" uniqueName="cn=users,o=defaultWIMFileBasedRealm"/>
</wim:entities>
</wim:Root>
</sdo:datagraph>
Gráfico de dados de entrada para criar uma entidade pai, OrgContainer, o:
<?xml version="1.0" encoding="UTF-8"?>
<sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sdo="commonj.sdo" xmlns:wim="http://www.ibm.com/websphere/wim">
<wim:Root>
<wim:entities xsi:type="wim:OrgContainer">
<wim:parent xsi:type="wim:OrgContainer">
<wim:identifier externalName="cn=users,o=defaultWIMFileBasedRealm" repositoryId="InternalFileRepository"
uniqueId="ecf1d16b-9ab8-4de6-a2a5-7eb48fd2fe7c" uniqueName="cn=users,o=defaultWIMFileBasedRealm"/>
</wim:parent>
<wim:o>SWG</wim:o>
</wim:entities>
</wim:Root>
</sdo:datagraph>
Gráfico de dados de saída depois de criar uma entidade pai, OrgContainer, o:
<?xml version="1.0" encoding="UTF-8"?>
<sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sdo="commonj.sdo" xmlns:wim="http://www.ibm.com/websphere/wim">
<wim:Root>
<wim:entities xsi:type="wim:OrgContainer">
<wim:identifier externalName="o=SWG,cn=users,o=defaultWIMFileBasedRealm" repositoryId="InternalFileRepository"
uniqueId="e6fc7e62-7492-44f9-8db6-4bccbc40429e" uniqueName="o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
</wim:entities>
</wim:Root>
</sdo:datagraph>
Gráfico de dados de entrada para criar uma entidade pai, OrgContainer, ou:
<?xml version="1.0" encoding="UTF-8"?>
<sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sdo="commonj.sdo" xmlns:wim="http://www.ibm.com/websphere/wim">
<wim:Root>
<wim:entities xsi:type="wim:OrgContainer">
<wim:parent xsi:type="wim:OrgContainer">
<wim:identifier externalName="o=SWG,cn=users,o=defaultWIMFileBasedRealm" repositoryId="InternalFileRepository"
uniqueId="e6fc7e62-7492-44f9-8db6-4bccbc40429e" uniqueName="o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
</wim:parent>
<wim:ou>India</wim:ou>
</wim:entities>
</wim:Root>
</sdo:datagraph>
Gráfico de dados de saída depois de criar uma entidade pai, OrgContainer, ou:
<?xml version="1.0" encoding="UTF-8"?>
<sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sdo="commonj.sdo" xmlns:wim="http://www.ibm.com/websphere/wim">
<wim:Root>
<wim:entities xsi:type="wim:OrgContainer">
<wim:identifier externalName="ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"
repositoryId="InternalFileRepository" uniqueId="2c281163-3daf-4223-bc63-6cf3f6502c4d"
uniqueName="ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
</wim:entities>
</wim:Root>
</sdo:datagraph>
Gráfico de dados de entrada para criar uma entidade filha, user1:
<?xml version="1.0" encoding="UTF-8"?>
<sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sdo="commonj.sdo" xmlns:wim="http://www.ibm.com/websphere/wim">
<wim:Root>
<wim:entities xsi:type="wim:PersonAccount">
<wim:parent xsi:type="wim:OrgContainer">
<wim:identifier externalName="ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"
repositoryId="InternalFileRepository" uniqueId="2c281163-3daf-4223-bc63-6cf3f6502c4d"
uniqueName="ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
</wim:parent>
<wim:uid>user1</wim:uid>
<wim:cn>user1cn</wim:cn>
<wim:sn>user1sn</wim:sn>
</wim:entities>
</wim:Root>
</sdo:datagraph>
Gráfico de dados de saída depois de criar uma entidade filha, user1:
<?xml version="1.0" encoding="UTF-8"?>
<sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sdo="commonj.sdo" xmlns:wim="http://www.ibm.com/websphere/wim">
<wim:Root>
<wim:entities xsi:type="wim:PersonAccount">
<wim:identifier externalName="uid=user1,ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"
repositoryId="InternalFileRepository" uniqueId="664e4422-d9b6-4b0e-a9e8-62620c6c710f"
uniqueName="uid=user1,ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
</wim:entities>
</wim:Root>
</sdo:datagraph>
Gráfico de dados de entrada para criar uma entidade filha, user2:
<?xml version="1.0" encoding="UTF-8"?>
<sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sdo="commonj.sdo" xmlns:wim="http://www.ibm.com/websphere/wim">
<wim:Root>
<wim:entities xsi:type="wim:PersonAccount">
<wim:parent xsi:type="wim:OrgContainer">
<wim:identifier externalName="ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"
repositoryId="InternalFileRepository" uniqueId="2c281163-3daf-4223-bc63-6cf3f6502c4d"
uniqueName="ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
</wim:parent>
<wim:uid>user2</wim:uid>
<wim:cn>user2cn</wim:cn>
<wim:sn>user2sn</wim:sn>
</wim:entities>
</wim:Root>
</sdo:datagraph>
Gráfico de dados de saída depois de criar uma entidade filha, user2:
<?xml version="1.0" encoding="UTF-8"?>
<sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sdo="commonj.sdo" xmlns:wim="http://www.ibm.com/websphere/wim">
<wim:Root>
<wim:entities xsi:type="wim:PersonAccount">
<wim:identifier externalName="uid=user2,ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"
repositoryId="InternalFileRepository" uniqueId="664e4422-d9b6-4b0e-a9e8-62620c6c710f"
uniqueName="uid=user2,ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
</wim:entities>
</wim:Root>
</sdo:datagraph>
Gráfico de dados de entrada para obter descendentes da entidade pai:
<?xml version="1.0" encoding="UTF-8"?>
<sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sdo="commonj.sdo" xmlns:wim="http://www.ibm.com/websphere/wim">
<wim:Root>
<wim:entities>
<wim:identifier uniqueName="cn=users,o=defaultWIMFileBasedRealm"/>
</wim:entities>
<wim:controls xsi:type="wim:DescendantControl" level="0">
<wim:properties>uid</wim:properties>
<wim:properties>ou</wim:properties>
<wim:properties>o</wim:properties>
</wim:controls>
</wim:Root>
</sdo:datagraph>
Gráfico de dados de saída depois de obter descendentes da entidade pai:
<?xml version="1.0" encoding="UTF-8"?>
<sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sdo="commonj.sdo" xmlns:wim="http://www.ibm.com/websphere/wim">
<wim:Root>
<wim:entities xsi:type="wim:OrgContainer">
<wim:identifier externalName="cn=users,o=defaultWIMFileBasedRealm" repositoryId="InternalFileRepository"
uniqueId="c9218bab-2444-4c56-8697-88a83a1d82f9" uniqueName="cn=users,o=defaultWIMFileBasedRealm"/>
<wim:children xsi:type="wim:OrgContainer">
<wim:identifier externalId="14126738-5bbe-4d3f-8589-ef71b8724696"
externalName="o=SWG,cn=users,o=defaultWIMFileBasedRealm"
repositoryId="InternalFileRepository" uniqueId="14126738-5bbe-4d3f-8589-ef71b8724696"
uniqueName="o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
<wim:o>SWG</wim:o>
</wim:children>
<wim:children xsi:type="wim:OrgContainer">
<wim:identifier externalId="22200d23-5fec-4d5f-9033-5c8c925e7a82"
externalName="ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"
repositoryId="InternalFileRepository" uniqueId="22200d23-5fec-4d5f-9033-5c8c925e7a82"
uniqueName="ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
<wim:ou>India</wim:ou>
</wim:children>
<wim:children xsi:type="wim:PersonAccount">
<wim:identifier externalId="63cbb4ca-a629-4a64-9681-98154ec877b6"
externalName="uid=user2,ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"
repositoryId="InternalFileRepository" uniqueId="63cbb4ca-a629-4a64-9681-98154ec877b6"
uniqueName="uid=user2,ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
<wim:uid>user2</wim:uid>
</wim:children>
<wim:children xsi:type="wim:PersonAccount">
<wim:identifier externalId="7f421b09-e22a-4311-9e2f-7b59f77b6d21"
externalName="uid=user1,ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"
repositoryId="InternalFileRepository" uniqueId="7f421b09-e22a-4311-9e2f-7b59f77b6d21"
uniqueName="uid=user1,ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
<wim:uid>user1</wim:uid>
</wim:children>
</wim:entities>
</wim:Root>
</sdo:datagraph>
Gráfico de dados de entrada para obter ancestrais da entidade filha:
<?xml version="1.0" encoding="UTF-8"?>
<sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sdo="commonj.sdo" xmlns:wim="http://www.ibm.com/websphere/wim">
<wim:Root>
<wim:entities xsi:type="wim:PersonAccount">
<wim:identifier externalName="uid=user1,ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"
repositoryId="InternalFileRepository" uniqueId="9f57af27-573b-4924-a405-7e35e7be012a"
uniqueName="uid=user1,ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
</wim:entities>
<wim:controls xsi:type="wim:AncestorControl" level="0">
<wim:properties>cn</wim:properties>
<wim:properties>ou</wim:properties>
<wim:properties>o</wim:properties>
</wim:controls>
</wim:Root>
</sdo:datagraph>
Gráfico de dados de saída depois de obter ancestrais da entidade filha:
<?xml version="1.0" encoding="UTF-8"?>
<sdo:datagraph xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:sdo="commonj.sdo" xmlns:wim="http://www.ibm.com/websphere/wim">
<wim:Root>
<wim:entities xsi:type="wim:PersonAccount">
<wim:identifier externalName="uid=user1,ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"
repositoryId="InternalFileRepository" uniqueId="9f57af27-573b-4924-a405-7e35e7be012a"
uniqueName="uid=user1,ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
<wim:parent xsi:type="wim:OrgContainer">
<wim:identifier externalId="127bac7a-50da-4616-907b-f7345873c087"
externalName="ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"
repositoryId="InternalFileRepository" uniqueId="127bac7a-50da-4616-907b-f7345873c087"
uniqueName="ou=India,o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
<wim:parent xsi:type="wim:OrgContainer">
<wim:identifier externalId="7e1c0b12-e45b-4595-bfb6-5d39e5741642"
externalName="o=SWG,cn=users,o=defaultWIMFileBasedRealm"
repositoryId="InternalFileRepository" uniqueId="7e1c0b12-e45b-4595-bfb6-5d39e5741642"
uniqueName="o=SWG,cn=users,o=defaultWIMFileBasedRealm"/>
<wim:parent xsi:type="wim:OrgContainer">
<wim:identifier externalId="ef168b8d-baed-4cd1-9f10-999866ea4c29"
externalName="cn=users,o=defaultWIMFileBasedRealm"
repositoryId="InternalFileRepository" uniqueId="ef168b8d-baed-4cd1-9f10-999866ea4c29"
uniqueName="cn=users,o=defaultWIMFileBasedRealm"/>
<wim:cn>users</wim:cn>
</wim:parent>
<wim:o>SWG</wim:o>
</wim:parent>
<wim:ou>India</wim:ou>
</wim:parent>
</wim:entities>
</wim:Root>
</sdo:datagraph>