Merge admin framework from config-prototype-branch onto trunk.

matthew_swift

23.26.2007 feb5d90ec016c99712f19c5485cf7633cd38f111

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
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
/*
 * 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
 *
 *
 *      Portions Copyright 2007 Sun Microsystems, Inc.
 */
 
package org.opends.server.admin.client.ldap;
 
 
 
import java.util.LinkedList;
 
import javax.naming.InvalidNameException;
import javax.naming.ldap.LdapName;
import javax.naming.ldap.Rdn;
 
import org.opends.server.admin.InstantiableRelationDefinition;
import org.opends.server.admin.LDAPProfile;
import org.opends.server.admin.ManagedObjectPath;
import org.opends.server.admin.ManagedObjectPathSerializer;
import org.opends.server.admin.OptionalRelationDefinition;
import org.opends.server.admin.RelationDefinition;
import org.opends.server.admin.SingletonRelationDefinition;
 
 
 
/**
 * A strategy for creating <code>LdapName</code>s from managed object paths.
 */
final class LDAPNameBuilder implements ManagedObjectPathSerializer {
 
  /**
   * Creates a new LDAP name representing the specified managed object path.
   *
   * @param path
   *          The managed object path.
   * @return Returns a new LDAP name representing the specified managed object
   *         path.
   */
  public static LdapName create(ManagedObjectPath path) {
    LDAPNameBuilder builder = new LDAPNameBuilder();
    path.serialize(builder);
    return builder.getInstance();
  }
 
 
 
  /**
   * Creates a new LDAP name representing the specified managed object path and
   * instantiable relation.
   *
   * @param path
   *          The managed object path.
   * @param relation
   *          The child instantiable relation.
   * @return Returns a new LDAP name representing the specified managed object
   *         path and instantiable relation.
   */
  public static LdapName create(ManagedObjectPath path,
      InstantiableRelationDefinition<?, ?> relation) {
    LDAPNameBuilder builder = new LDAPNameBuilder();
    path.serialize(builder);
    builder.appendManagedObjectPathElement(relation);
    return builder.getInstance();
  }
 
  // The list of RDNs in big-endian order.
  private final LinkedList<Rdn> rdns;
 
  // The LDAP profile.
  private final LDAPProfile profile;
 
 
 
  /**
   * Create a new JNDI LDAP name builder.
   */
  public LDAPNameBuilder() {
    this.rdns = new LinkedList<Rdn>();
    this.profile = LDAPProfile.getInstance();
  }
 
 
 
  /**
   * {@inheritDoc}
   */
  public void appendManagedObjectPathElement(
      InstantiableRelationDefinition<?, ?> r, String name) {
    // Add the RDN sequence representing the relation.
    appendManagedObjectPathElement((RelationDefinition) r);
 
    // Now add the single RDN representing the named instance.
    String type = profile.getInstantiableRelationChildRDNType(r);
    try {
      Rdn rdn = new Rdn(type, name.trim());
      rdns.add(rdn);
    } catch (InvalidNameException e1) {
      // Should not happen.
      throw new RuntimeException(e1);
    }
  }
 
 
 
  /**
   * Appends the RDN sequence representing the provided relation.
   *
   * @param r
   *          The relation definition.
   */
  public void appendManagedObjectPathElement(RelationDefinition<?, ?> r) {
    // Add the RDN sequence representing the relation.
    try {
      LdapName tmp = new LdapName(profile.getRelationRDNSequence(r));
      rdns.addAll(tmp.getRdns());
    } catch (InvalidNameException e1) {
      // Should not happen.
      throw new RuntimeException(e1);
    }
  }
 
 
 
  /**
   * {@inheritDoc}
   */
  public void appendManagedObjectPathElement(
      OptionalRelationDefinition<?, ?> r) {
    // Add the RDN sequence representing the relation.
    appendManagedObjectPathElement((RelationDefinition) r);
  }
 
 
 
  /**
   * {@inheritDoc}
   */
  public void appendManagedObjectPathElement(
      SingletonRelationDefinition<?, ?> r) {
    // Add the RDN sequence representing the relation.
    appendManagedObjectPathElement((RelationDefinition) r);
  }
 
 
 
  /**
   * Create a new JNDI LDAP name using the current state of this LDAP name
   * builder.
   *
   * @return Returns the new JNDI LDAP name instance.
   */
  public LdapName getInstance() {
    return new LdapName(rdns);
  }
}