Código de amostra para criar uma entidade em uma hierarquia e obter descendentes e ancestrais

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:

  1. Crie uma hierarquia com entidades do tipo de entidade OrgContainer na região padrão.
  2. Crie uma entidade filha sob a hierarquia OrgContainer.
  3. Obtenha os descendentes da entidade pai usando o método get() e DescendantControl.
  4. Obtenha os ancestrais da entidade filha usando o método get() e AscendantControl.

Pré-requisito

Assegure-se de ter lido as informações e concluído as etapas descritas no tópico Pré-requisitos de Programação.

Código de Amostra

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áficos de Dados de Entrada e Saída

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>


Termos de uso | Feedback