Examples of javax.naming.directory.DirContext

javax.naming.directory.DirContext
This is the main interface to a directory service.
A DirContext is the interface through which a client interacts with a particular concrete directory service provider. The API provides methods for searching, reading and writing attributes of directory entries.

The name of a directory entry is taken as relative to the context receiving the method invocation. Names cannot be null and the empty name has a special meaning of the context itself.

In this interface there are duplicated methods that take either a String or Name parameter. This is simply a convenience and the behavior of each method is identical.

The semantics of a name in a DirContext is exactly equivalent to that of a name in a regular naming Context.
Attribute storage models
JNDI supports two logical models of attribute storage:
- Type A : where an attribute operation on a named object is equivalent to a lookup in the DirContext on the given name followed by application of the operation to the resulting empty DirContext. Think of this as attributes being stored on the object itself.
- Type B : where an attribute operation on a named object is equivalent to a lookup on that name in the parent DirContext followed by application of the operation on the parent DirContext providing the name as an argument. Think of this as the attributes being stored in the parent context.
  In this model objects that are not DirContext can have attributes, provided their parents are DirContext.
The directory service provider can implement either of these logical models, and the client is expeced to know which model it is dealing with.
Attribute Name aliasing
Directory service providers are free to implement attribute name alising. If the service employs alising then the list of attribute names that are returned as a result of API calls to get a named attribute, or search for a set of attributes may include attributes whose name was not in the search list. Implmentations should not rely on the preservation of attribute names.
Searching and operational attributes
Some directory service providers support "operational attributes" on objects. These are attributes that are computed by the provider, or have other special semantics to the directory service. The directory service defines which attributes are operational.

The API calls for searching for attributes, and those for getting named attributes using a list of names are defined to interpret the null argument to match all non-operational attributes.

It is therefore possible to get a specific named attribute that is not returned in a global retrieval of all object attributes.
Conditions
Some APIs require that the name resolves to another DirContext and not an object. In such cases, if this postcondition is not met then the method should throw a NotContextException. Other methods can resolve to be either objects or DirContext.

Service providers must not modify collection parameters such as Attribute, SearchControl or arrays. Similarly, clients are expected not to modify the collections while the service provider iterates over such collections -- the service provider should be given exclusive control of the collection until the method returns.

APIs that return collections are safe -- that is, the service provider will not modify collections that are returned to clients.
Exceptions
Any method may throw a NamingException (or subclass) as defined by the exception descriptions.

     * Test a search done on cn=schema
     */
    @Test
    public void testSubSchemaSubEntrySearch() throws Exception
    {
        DirContext ctx = getWiredContext( getLdapServer() );


        SearchControls searchControls = new SearchControls();
        searchControls.setSearchScope( SearchControls.OBJECT_SCOPE );
        searchControls.setReturningAttributes( new String[]
            { "objectClasses" } );
        NamingEnumeration<SearchResult> results = ctx.search( "cn=schema", "(ObjectClass=*)", searchControls );


        assertTrue( results.hasMore() );
        SearchResult result = results.next();
        Attributes entry = result.getAttributes();

View Full Code Here

     * "c=usa, ou=system", and ask for a subtree search
     */
    @Test
    public void testSearchBaseWithReferralThrowAfterMoveAndRename() throws Exception
    {
        DirContext ctx = getWiredContextThrowOnRefferal( getLdapServer() );


        SearchControls controls = new SearchControls();
        controls.setSearchScope( SearchControls.OBJECT_SCOPE );


        try
        {
            ctx.search( "c=america,ou=Countries,ou=system", "(cn=alex karasulu)", controls );
            fail( "Should fail here throwing a ReferralException" );
        }
        catch ( ReferralException re )
        {
            String referral = ( String ) re.getReferralInfo();
            assertEquals( "ldap://localhost:" + getLdapServer().getPort() + "/c=usa,ou=system??base", referral );
        }


        ( ( LdapContext ) ctx ).setRequestControls( new javax.naming.ldap.Control[]
            { new ManageReferralControl() } );


        // Now let's move the entry
        ctx.rename( "c=america,ou=Countries,ou=system", "c=us,ou=system" );


        controls.setSearchScope( SearchControls.OBJECT_SCOPE );


        ( ( LdapContext ) ctx ).setRequestControls( new javax.naming.ldap.Control[]
            {} );


        try
        {
            NamingEnumeration<SearchResult> results = ctx.search( "c=us,ou=system", "(cn=alex karasulu)", controls );


            results.next();
            fail( "Should fail here throwing a ReferralException" );
        }
        catch ( ReferralException re )

View Full Code Here

        // Create entry cn=Sid Vicious, ou=system
        Attributes vicious = LdifUtils.createJndiAttributes( "objectClass: top", "objectClass: person",
            "cn: Sid Vicious",
            "sn: Vicious", "description: (sex*pis\\tols)" );


        DirContext ctx = sysRoot.createSubcontext( "cn=Sid Vicious", vicious );
        assertNotNull( ctx );


        ctx = ( DirContext ) sysRoot.lookup( "cn=Sid Vicious" );
        assertNotNull( ctx );


        Attributes attributes = ctx.getAttributes( "" );


        assertEquals( "(sex*pis\\tols)", attributes.get( "description" ).get() );


        // Now, search for the description
        SearchControls controls = new SearchControls();

View Full Code Here

        // Create entry cn=Sid Vicious, ou=system
        Attributes vicious = LdifUtils.createJndiAttributes( "objectClass: top", "objectClass: person",
            "cn: Sid Vicious",
            "sn: Vicious", "description: (sex*pis\\tols)" );


        DirContext ctx = sysRoot.createSubcontext( "cn=Sid Vicious", vicious );
        assertNotNull( ctx );


        ctx = ( DirContext ) sysRoot.lookup( "cn=Sid Vicious" );
        assertNotNull( ctx );


        Attributes attributes = ctx.getAttributes( "" );


        assertEquals( "(sex*pis\\tols)", attributes.get( "description" ).get() );


        // Now, search for the description
        SearchControls controls = new SearchControls();

View Full Code Here

     * if they are requested.
     */
    @Test
    public void testRequestOperationalAttributes() throws Exception
    {
        DirContext ctx = getWiredContext( getLdapServer() );
        SearchControls ctls = new SearchControls();


        String[] attrNames =
            { "creatorsName", "createTimestamp", "modifiersName", "modifyTimestamp" };


        ctls.setSearchScope( SearchControls.OBJECT_SCOPE );
        ctls.setReturningAttributes( attrNames );


        NamingEnumeration<SearchResult> result = ctx.search( DN, FILTER, ctls );


        if ( result.hasMore() )
        {
            SearchResult entry = result.next();
            checkForAttributes( entry.getAttributes(), attrNames );

View Full Code Here

     * if + is requested.
     */
    @Test
    public void testRequestAllOperationalAttributes() throws Exception
    {
        DirContext ctx = getWiredContext( getLdapServer() );
        SearchControls ctls = new SearchControls();


        ctls.setSearchScope( SearchControls.OBJECT_SCOPE );
        ctls.setReturningAttributes( new String[]
            { "+" } );


        NamingEnumeration<SearchResult> result = ctx.search( DN, FILTER, ctls );


        if ( result.hasMore() )
        {
            SearchResult entry = result.next();
            String[] attrNames =

View Full Code Here

     * the dynamic schema fails when no result is found.
     */
    @Test
    public void testSearchingNewSchemaElements() throws Exception
    {
        DirContext ctx = getWiredContext( getLdapServer() );


        // create an entry with the schema objectClass personActiveDirectory
        Attributes person = new BasicAttributes( "objectClass", "top", true );
        person.get( "objectClass" ).add( "person" );
        person.get( "objectClass" ).add( "personActiveDirectory" );
        person.put( "cn", "foobar" );
        person.put( "sn", "bar" );
        person.put( "pwdLastSet", "3" );
        person.put( "SourceAD", "blah" );
        person.put( "useraccountcontrol", "7" );
        person.put( "sAMAccountName", "foobar" );
        ctx.createSubcontext( "cn=foobar,ou=system", person );


        // Confirm creation with a lookup
        Attributes read = ctx.getAttributes( "cn=foobar,ou=system" );
        assertNotNull( read );
        assertEquals( "3", read.get( "pwdLastSet" ).get() );


        // Now search for foobar with pwdLastSet value of 3
        SearchControls searchControls = new SearchControls();
        searchControls.setSearchScope( SearchControls.ONELEVEL_SCOPE );
        NamingEnumeration<SearchResult> results = ctx.search( "ou=system", "(pwdLastSet=3)", searchControls );
        assertTrue( results.hasMore() );
        SearchResult result = results.next();
        assertNotNull( result );
        assertEquals( "cn=foobar", result.getName() );
        Attributes attributes = result.getAttributes();
        assertEquals( "3", attributes.get( "pwdLastSet" ).get() );
        results.close();


        // Now search with bogus value for pwdLastSet
        results = ctx.search( "ou=system", "(pwdLastSet=300)", searchControls );
        assertFalse( results.hasMore() );
        results.close();
    }

View Full Code Here

     */
    @Test
    public void testPagedSearchtest12() throws Exception
    {
        getLdapServer().setMaxSizeLimit( 5 );
        DirContext ctx = getWiredContext( getLdapServer() );
        SearchControls controls = createSearchControls( ctx, 4, 3 );


        doLoop( ctx, controls, 3, 2, 4, true );
    }

View Full Code Here

     */
    @Test
    public void testPagedSearchtest13() throws Exception
    {
        getLdapServer().setMaxSizeLimit( 4 );
        DirContext ctx = getWiredContext( getLdapServer() );
        SearchControls controls = createSearchControls( ctx, 5, 3 );


        doLoop( ctx, controls, 3, 2, 5, true );
    }

View Full Code Here

     */
    @Test
    public void testPagedSearchtest14() throws Exception
    {
        getLdapServer().setMaxSizeLimit( 4 );
        DirContext ctx = getWiredContext( getLdapServer() );
        SearchControls controls = createSearchControls( ctx, 3, 5 );


        doLoop( ctx, controls, 5, 1, 3, true );
    }

View Full Code Here

0 1 2 3 4 5 6 7 8 9

TOP

Related Classes of javax.naming.directory.DirContext

com.cloud.configuration.ConfigurationManagerImpl

com.springsource.insight.plugin.ldap.DirContextSearchCollectionAspectTest

com.stimulus.archiva.security.realm.ADAction

com.sun.enterprise.security.auth.realm.ldap.LDAPRealm

com.sun.messaging.jmq.jmsserver.auth.ldap.LdapUserRepository

de.sub.goobi.helper.ldap.Ldap

fr.norsys.mapper.console.service.LdapTreeBuilderImpl

fr.norsys.mapper.console.service.LDAPViewerImpl

fr.norsys.mapper.console.service.LDAPViewerTest

fr.norsys.mapper.console.service.ValidationHelperImpl

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.