View Javadoc
1   /*
2    *  Licensed to the Apache Software Foundation (ASF) under one
3    *  or more contributor license agreements.  See the NOTICE file
4    *  distributed with this work for additional information
5    *  regarding copyright ownership.  The ASF licenses this file
6    *  to you under the Apache License, Version 2.0 (the
7    *  "License"); you may not use this file except in compliance
8    *  with the License.  You may obtain a copy of the License at
9    *
10   *    https://www.apache.org/licenses/LICENSE-2.0
11   *
12   *  Unless required by applicable law or agreed to in writing,
13   *  software distributed under the License is distributed on an
14   *  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15   *  KIND, either express or implied.  See the License for the
16   *  specific language governing permissions and limitations
17   *  under the License.
18   *
19   */
20  package org.apache.directory.api.ldap.codec.actions.request.search;
21  
22  
23  import org.apache.directory.api.asn1.DecoderException;
24  import org.apache.directory.api.asn1.ber.grammar.GrammarAction;
25  import org.apache.directory.api.asn1.ber.tlv.BerValue;
26  import org.apache.directory.api.asn1.ber.tlv.IntegerDecoder;
27  import org.apache.directory.api.asn1.ber.tlv.IntegerDecoderException;
28  import org.apache.directory.api.asn1.ber.tlv.TLV;
29  import org.apache.directory.api.i18n.I18n;
30  import org.apache.directory.api.ldap.codec.api.LdapCodecConstants;
31  import org.apache.directory.api.ldap.codec.api.LdapMessageContainer;
32  import org.apache.directory.api.ldap.model.message.AliasDerefMode;
33  import org.apache.directory.api.ldap.model.message.SearchRequest;
34  import org.slf4j.Logger;
35  import org.slf4j.LoggerFactory;
36  
37  
38  /**
39   * The action used to store the SearchRequest derefAlias flag
40   * <pre>
41   * SearchRequest ::= [APPLICATION 3] SEQUENCE {
42   *     ...
43   *     derefAliases ENUMERATED {
44   *         neverDerefAliases   (0),
45   *         derefInSearching    (1),
46   *         derefFindingBaseObj (2),
47   *         derefAlways         (3) },
48   *     ...
49   * </pre>
50   * @author <a href="mailto:dev@directory.apache.org">Apache Directory Project</a>
51   */
52  public class StoreSearchRequestDerefAlias extends GrammarAction<LdapMessageContainer<SearchRequest>>
53  {
54      /** The logger */
55      private static final Logger LOG = LoggerFactory.getLogger( StoreSearchRequestDerefAlias.class );
56  
57      /**
58       * Instantiates a new action.
59       */
60      public StoreSearchRequestDerefAlias()
61      {
62          super( "Store SearchRequest derefAlias flag" );
63      }
64  
65  
66      /**
67       * {@inheritDoc}
68       */
69      public void action( LdapMessageContainer<SearchRequest> container ) throws DecoderException
70      {
71          SearchRequest searchRequest = container.getMessage();
72  
73          TLV tlv = container.getCurrentTLV();
74  
75          // We have to check that this is a correct derefAliases
76          BerValue value = tlv.getValue();
77  
78          try
79          {
80              int derefAliases = IntegerDecoder.parse( value, LdapCodecConstants.NEVER_DEREF_ALIASES,
81                  LdapCodecConstants.DEREF_ALWAYS );
82              searchRequest.setDerefAliases( AliasDerefMode.getDerefMode( derefAliases ) );
83          }
84          catch ( IntegerDecoderException ide )
85          {
86              String msg = I18n.err( I18n.ERR_05150_BAD_DEREF_ALIAS, value.toString() );
87              LOG.error( msg );
88              throw new DecoderException( msg, ide );
89          }
90  
91  
92          if ( LOG.isDebugEnabled() )
93          {
94              switch ( searchRequest.getDerefAliases() )
95              {
96                  case NEVER_DEREF_ALIASES:
97                      LOG.debug( I18n.msg( I18n.MSG_05161_HANDLING_OBJECT_STRATEGY, "NEVER_DEREF_ALIASES" ) );
98                      break;
99  
100                 case DEREF_IN_SEARCHING:
101                     LOG.debug( I18n.msg( I18n.MSG_05161_HANDLING_OBJECT_STRATEGY, "DEREF_IN_SEARCHING" ) );
102                     break;
103 
104                 case DEREF_FINDING_BASE_OBJ:
105                     LOG.debug( I18n.msg( I18n.MSG_05161_HANDLING_OBJECT_STRATEGY, "DEREF_FINDING_BASE_OBJ" ) );
106                     break;
107 
108                 case DEREF_ALWAYS:
109                     LOG.debug( I18n.msg( I18n.MSG_05161_HANDLING_OBJECT_STRATEGY, "DEREF_ALWAYS" ) );
110                     break;
111 
112                 default:
113                     LOG.debug( I18n.msg( I18n.MSG_05161_HANDLING_OBJECT_STRATEGY, "UNKNOWN" ) );
114             }
115         }
116     }
117 }