Examples of org.apache.directory.shared.ldap.model.message.Referral

Package org.apache.directory.shared.ldap.model.message

Examples of org.apache.directory.shared.ldap.model.message.Referral

org.apache.directory.shared.ldap.model.message.Referral

aqs.org/rfcs/rfc2251.html"> RFC 2251 has to say about it:

4.1.11. Referral The referral error indicates that the contacted server does not hold the target entry of the request. The referral field is present in an LDAPResult if the LDAPResult.resultCode field value is referral, and absent with all other result codes. It contains a reference to another server (or set of servers) which may be accessed via LDAP or other protocols. Referrals can be returned in response to any operation request (except unbind and abandon which do not have responses). At least one URL MUST be present in the Referral. The referral is not returned for a singleLevel or wholeSubtree search in which the search scope spans multiple naming contexts, and several different servers would need to be contacted to complete the operation. Instead, continuation references, described in section 4.5.3, are returned. Referral ::= SEQUENCE OF LDAPURL -- one or more LDAPURL ::= LDAPString -- limited to characters permitted in URLs If the client wishes to progress the operation, it MUST follow the referral by contacting any one of servers. All the URLs MUST be equally capable of being used to progress the operation. (The mechanisms for how this is achieved by multiple servers are outside the scope of this document.) URLs for servers implementing the LDAP protocol are written according to <a href="http://www.faqs.org/rfcs/rfc2255.html">[9]</a>. If an alias was dereferenced, the <dn> part of the URL MUST be present, with the new target object name. If the <dn> part is present, the client MUST use this name in its next request to progress the operation, and if it is not present the client will use the same name as in the original request. Some servers (e.g. participating in distributed indexing) may provide a different filter in a referral for a search operation. If the filter part of the URL is present in an LDAPURL, the client MUST use this filter in its next request to progress this search, and if it is not present the client MUST use the same filter as it used for that search. Other aspects of the new request may be the same or different as the request which generated the referral. Note that UTF-8 characters appearing in a Dn or search filter may not be legal for URLs (e.g. spaces) and MUST be escaped using the % method in RFC 1738 <a href="http://www.faqs.org/rfcs/rfc1738.html">[7]</a>. Other kinds of URLs may be returned, so long as the operation could be performed using that protocol.

@author Apache Directory ProjectTODO This interface should be located in a url package under common to be constructed from a LDAPv3 URL parser. The interface will eventually look very different once url support is added: for one it will add and remove LdapUrl objects instead of strings or provide both string and LdapUrl add/remove methods.

            }


            // Add the referrals if necessary
            if ( e instanceof LdapReferralException )
            {
                Referral referrals = new ReferralImpl();


                do
                {
                    String ref = ( (LdapReferralException) e ).getReferralInfo();
                    referrals.addLdapUrl( ref );
                }
                while ( ( ( LdapReferralException ) e ).skipReferral() );


                result.setReferral( referrals );
            }

View Full Code Here

        assertEquals( 1, addResponse.getMessageId() );
        assertEquals( ResultCodeEnum.REFERRAL, addResponse.getLdapResult().getResultCode() );
        assertEquals( "", addResponse.getLdapResult().getMatchedDn().getName() );
        assertEquals( "", addResponse.getLdapResult().getDiagnosticMessage() );


        Referral referral = addResponse.getLdapResult().getReferral();


        assertNotNull( referral );
        assertEquals( 1, referral.getLdapUrls().size() );
        Collection<String> ldapUrls = referral.getLdapUrls();


        assertTrue( ldapUrls.contains( "ldap:///" ) );


        try
        {

View Full Code Here

        assertEquals( 1, addResponse.getMessageId() );
        assertEquals( ResultCodeEnum.REFERRAL, addResponse.getLdapResult().getResultCode() );
        assertEquals( "", addResponse.getLdapResult().getMatchedDn().getName() );
        assertEquals( "", addResponse.getLdapResult().getDiagnosticMessage() );


        Referral referral = addResponse.getLdapResult().getReferral();


        assertNotNull( referral );


        assertEquals( 2, referral.getLdapUrls().size() );


        Collection<String> ldapUrls = referral.getLdapUrls();


        for ( String ldapUrl : ldapUrls )
        {
            assertEquals( "ldap:///", ldapUrl );
        }

View Full Code Here

        assertEquals( 1, addResponse.getMessageId() );
        assertEquals( ResultCodeEnum.REFERRAL, addResponse.getLdapResult().getResultCode() );
        assertEquals( "", addResponse.getLdapResult().getMatchedDn().getName() );
        assertEquals( "", addResponse.getLdapResult().getDiagnosticMessage() );


        Referral referral = addResponse.getLdapResult().getReferral();


        assertNotNull( referral );


        assertEquals( 2, referral.getLdapUrls().size() );


        Collection<String> ldapUrls = referral.getLdapUrls();


        String[] expected = new String[]
            { "ldap:///", "" };
        int i = 0;

View Full Code Here


        // The error message
        BerValue.encode( buffer, getErrorMessageBytes() );


        // The referrals, if any
        Referral referral = getReferral();


        if ( referral != null )
        {
            LdapEncoder.encodeReferral( buffer, referral );
        }

View Full Code Here

    public int computeLength()
    {
        int searchResultReferenceLength = 0;


        // We may have more than one reference.
        Referral referral = getReferral();


        int referralLength = LdapEncoder.computeReferralLength( referral );


        if ( referralLength != 0 )
        {

View Full Code Here

            // The SearchResultReference Tag
            buffer.put( LdapConstants.SEARCH_RESULT_REFERENCE_TAG );
            buffer.put( TLV.getBytes( getSearchResultReferenceLength() ) );


            // The referrals, if any
            Referral referral = searchResultReference.getReferral();


            if ( referral != null )
            {
                // Each referral
                for ( byte[] ldapUrlBytes : referral.getLdapUrlsBytes() )
                {
                    // Encode the current referral
                    BerValue.encode( buffer, ldapUrlBytes );
                }
            }

View Full Code Here

        }


        ResultResponse response = ( ResultResponse ) container.getMessage();
        LdapResult ldapResult = response.getLdapResult();


        Referral referral = new ReferralImpl();
        ldapResult.setReferral( referral );


        if ( IS_DEBUG )
        {
            LOG.debug( "Initialising a referrals list" );

View Full Code Here


        // Get the Value and store it in the BindRequest
        TLV tlv = container.getCurrentTLV();


        // Get the referral, or create it if not existing
        Referral referral = searchResultReference.getReferral();


        if ( referral == null )
        {
            referral = new ReferralImpl();
            searchResultReference.setReferral( referral );
        }


        // We have to handle the special case of a 0 length list of referrals
        LdapUrl url = LdapUrl.EMPTY_URL;


        if ( tlv.getLength() == 0 )
        {
            referral.addLdapUrl( "" );
        }
        else
        {
            String urlStr = Strings.utf8ToString( tlv.getValue().getData() );


            try
            {
                url = new LdapUrl( urlStr );
                referral.addLdapUrl( urlStr );
            }
            catch ( LdapURLEncodingException luee )
            {
                LOG.error( I18n.err( I18n.ERR_04021, urlStr, luee.getMessage() ) );
                throw new DecoderException( I18n.err( I18n.ERR_04016, luee.getMessage() ) );

View Full Code Here

    {
        TLV tlv = container.getCurrentTLV();


        Message response = container.getMessage();
        LdapResult ldapResult = ( ( ResultResponse ) response ).getLdapResult();
        Referral referral = ldapResult.getReferral();


        if ( tlv.getLength() == 0 )
        {
            referral.addLdapUrl( "" );
        }
        else
        {
            if ( ldapResult.getResultCode() == ResultCodeEnum.REFERRAL )
            {
                try
                {
                    String url = Strings.utf8ToString( tlv.getValue().getData() );
                    referral.addLdapUrl( new LdapUrl( url ).toString() );
                }
                catch ( LdapURLEncodingException luee )
                {
                    String badUrl = Strings.utf8ToString( tlv.getValue().getData() );
                    LOG.error( I18n.err( I18n.ERR_04015, badUrl, luee.getMessage() ) );
                    throw new DecoderException( I18n.err( I18n.ERR_04016, luee.getMessage() ) );
                }
            }
            else
            {
                LOG.warn( "The Referral error message is not allowed when havind an error code no equals to REFERRAL" );
                referral.addLdapUrl( LdapUrl.EMPTY_URL.toString() );
            }
        }


        if ( IS_DEBUG )
        {

View Full Code Here

0 1 2 3 4 5 6

TOP

Related Classes of org.apache.directory.shared.ldap.model.message.Referral

org.apache.directory.server.ldap.handlers.LdapRequestHandler

org.apache.directory.server.ldap.handlers.SearchHandler

org.apache.directory.shared.dsmlv2.reponse.LdapResultDsml

org.apache.directory.shared.ldap.codec.actions.InitReferralsAction

org.apache.directory.shared.ldap.codec.actions.ldapResult.AddReferral

org.apache.directory.shared.ldap.codec.actions.ldapResult.InitReferrals

org.apache.directory.shared.ldap.codec.actions.searchResultReference.StoreReference

org.apache.directory.shared.ldap.codec.actions.StoreReferenceAction

org.apache.directory.shared.ldap.codec.decorators.LdapResultDecorator

org.apache.directory.shared.ldap.codec.decorators.SearchResultReferenceDecorator

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.