AddRequestProtocolOp.java revision 998747bfaaa3c6b28bbfaf0e282e6c0ccbf46bc0
/*
* 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 legal-notices/CDDLv1_0.txt
* 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 legal-notices/CDDLv1_0.txt.
* 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 2006-2008 Sun Microsystems, Inc.
* Portions Copyright 2013-2015 ForgeRock AS
*/
/**
* This class defines the structures and methods for an LDAP add request
* protocol op, which is used to add a new entry to the Directory Server.
*/
public class AddRequestProtocolOp
extends ProtocolOp
{
/** The set of attributes for this add request. */
/** The DN for this add request. */
private ByteString dn;
/**
* Creates a new LDAP add request protocol op with the specified DN and no
* attributes.
*
* @param dn The DN for this add request.
*/
{
}
/**
* Creates a new LDAP add request protocol op with the specified DN and set of
* attributes.
*
* @param dn The DN for this add request.
* @param attributes The set of attributes for this add request.
*/
{
if (attributes == null)
{
}
else
{
this.attributes = attributes;
}
}
/**
* Retrieves the DN for this add request.
*
* @return The DN for this add request.
*/
public ByteString getDN()
{
return dn;
}
/**
* Retrieves the set of attributes for this add request. The returned list
* may be altered by the caller.
*
* @return The set of attributes for this add request.
*/
{
return attributes;
}
/**
* Retrieves the BER type for this protocol op.
*
* @return The BER type for this protocol op.
*/
public byte getType()
{
return OP_TYPE_ADD_REQUEST;
}
/**
* Retrieves the name for this protocol op type.
*
* @return The name for this protocol op type.
*/
public String getProtocolOpName()
{
return "Add Request";
}
/**
* Writes this protocol op to an ASN.1 output stream.
*
* @param stream The ASN.1 output stream to write to.
* @throws IOException If a problem occurs while writing to the stream.
*/
{
// Write the attributes
{
}
}
/**
* Appends a string representation of this LDAP protocol op to the provided
* buffer.
*
* @param buffer The buffer to which the string should be appended.
*/
{
if (! attributes.isEmpty())
{
{
}
}
}
/**
* Appends a multi-line string representation of this LDAP protocol op to the
* provided buffer.
*
* @param buffer The buffer to which the information should be appended.
* @param indent The number of spaces from the margin that the lines should
* be indented.
*/
{
for (int i=0 ; i < indent; i++)
{
}
{
}
}
/**
* Appends an LDIF representation of the entry to the provided buffer.
*
* @param buffer The buffer to which the entry should be appended.
* @param wrapColumn The column at which long lines should be wrapped.
*/
{
// Add the DN to the buffer.
int colsRemaining;
if (needsBase64Encoding(dn))
{
}
else
{
}
{
}
else
{
int startPos = colsRemaining;
{
}
{
}
}
// Add the attributes to the buffer.
for (RawAttribute a : attributes)
{
for (ByteString v : a.getValues())
{
if (needsBase64Encoding(v))
{
}
else
{
valueString = v.toString();
}
{
}
else
{
int startPos = colsRemaining;
{
}
if (startPos < valueLength)
{
}
}
}
}
// Make sure to add an extra blank line to ensure that there will be one
// between this entry and the next.
}
}