Fix issue 4446: allow empty attributes to be added to entries and also add ...

matthew_swift

08.28.2010 8cf467249a3cdfdab500aecd7b4dfaadd9f2c1bb

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License, Version 1.0 only
 * (the "License").  You may not use this file except in compliance
 * with the License.
 *
 * You can obtain a copy of the license at
 * trunk/opends/resource/legal-notices/OpenDS.LICENSE
 * or https://OpenDS.dev.java.net/OpenDS.LICENSE.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL HEADER in each
 * file and include the License file at
 * trunk/opends/resource/legal-notices/OpenDS.LICENSE.  If applicable,
 * add the following below this CDDL HEADER, with the fields enclosed
 * by brackets "[]" replaced with your own identifying information:
 *      Portions Copyright [yyyy] [name of copyright owner]
 *
 * CDDL HEADER END
 *
 *
 *      Copyright 2009 Sun Microsystems, Inc.
 */
 
package org.opends.sdk;
 
 
 
import java.net.InetSocketAddress;
import java.net.SocketAddress;
 
import com.sun.opends.sdk.ldap.LDAPConnectionFactoryImpl;
import com.sun.opends.sdk.util.Validator;
 
 
 
/**
 * A factory class which can be used to obtain connections to an LDAP Directory
 * Server.
 */
public final class LDAPConnectionFactory implements ConnectionFactory
{
  // We implement the factory using the pimpl idiom in order have
  // cleaner Javadoc which does not expose implementation methods from
  // AbstractConnectionFactory.
 
  private final LDAPConnectionFactoryImpl impl;
 
 
 
  /**
   * Creates a new LDAP connection factory which can be used to create LDAP
   * connections to the Directory Server at the provided address.
   *
   * @param address
   *          The address of the Directory Server.
   * @throws NullPointerException
   *           If {@code address} was {@code null}.
   */
  public LDAPConnectionFactory(final SocketAddress address)
      throws NullPointerException
  {
    this(address, new LDAPOptions());
  }
 
 
 
  /**
   * Creates a new LDAP connection factory which can be used to create LDAP
   * connections to the Directory Server at the provided address.
   *
   * @param address
   *          The address of the Directory Server.
   * @param options
   *          The LDAP options to use when creating connections.
   * @throws NullPointerException
   *           If {@code address} or {@code options} was {@code null}.
   */
  public LDAPConnectionFactory(final SocketAddress address,
      final LDAPOptions options) throws NullPointerException
  {
    Validator.ensureNotNull(address, options);
    this.impl = new LDAPConnectionFactoryImpl(address, options);
  }
 
 
 
  /**
   * Creates a new LDAP connection factory which can be used to create LDAP
   * connections to the Directory Server at the provided host and port address.
   *
   * @param host
   *          The host name.
   * @param port
   *          The port number.
   * @throws NullPointerException
   *           If {@code host} was {@code null}.
   */
  public LDAPConnectionFactory(final String host, final int port)
      throws NullPointerException
  {
    this(host, port, new LDAPOptions());
  }
 
 
 
  /**
   * Creates a new LDAP connection factory which can be used to create LDAP
   * connections to the Directory Server at the provided host and port address.
   *
   * @param host
   *          The host name.
   * @param port
   *          The port number.
   * @param options
   *          The LDAP options to use when creating connections.
   * @throws NullPointerException
   *           If {@code host} or {@code options} was {@code null}.
   */
  public LDAPConnectionFactory(final String host, final int port,
      final LDAPOptions options) throws NullPointerException
  {
    Validator.ensureNotNull(host, options);
    final SocketAddress address = new InetSocketAddress(host, port);
    this.impl = new LDAPConnectionFactoryImpl(address, options);
  }
 
 
 
  /**
   * {@inheritDoc}
   */
  public FutureResult<AsynchronousConnection> getAsynchronousConnection(
      final ResultHandler<AsynchronousConnection> handler)
  {
    return impl.getAsynchronousConnection(handler);
  }
 
 
 
  /**
   * {@inheritDoc}
   */
  public Connection getConnection() throws ErrorResultException,
      InterruptedException
  {
    return impl.getConnection();
  }
}