com.novell.ldap.LDAPDITContentRuleSchema Maven / Gradle / Ivy
/* **************************************************************************
* $OpenLDAP$
*
* Copyright (C) 1999, 2000, 2001 Novell, Inc. All Rights Reserved.
*
* THIS WORK IS SUBJECT TO U.S. AND INTERNATIONAL COPYRIGHT LAWS AND
* TREATIES. USE, MODIFICATION, AND REDISTRIBUTION OF THIS WORK IS SUBJECT
* TO VERSION 2.0.1 OF THE OPENLDAP PUBLIC LICENSE, A COPY OF WHICH IS
* AVAILABLE AT HTTP://WWW.OPENLDAP.ORG/LICENSE.HTML OR IN THE FILE "LICENSE"
* IN THE TOP-LEVEL DIRECTORY OF THE DISTRIBUTION. ANY USE OR EXPLOITATION
* OF THIS WORK OTHER THAN AS AUTHORIZED IN VERSION 2.0.1 OF THE OPENLDAP
* PUBLIC LICENSE, OR OTHER PRIOR WRITTEN CONSENT FROM NOVELL, COULD SUBJECT
* THE PERPETRATOR TO CRIMINAL AND CIVIL LIABILITY.
******************************************************************************/
package com.novell.ldap;
import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.Enumeration;
import java.util.Iterator;
import org.xml.sax.Attributes;
import org.xml.sax.SAXException;
import com.novell.ldap.client.AttributeQualifier;
import com.novell.ldap.client.SchemaParser;
import com.novell.ldap.util.LDAPXMLHandler;
import com.novell.ldap.util.SAXEventMultiplexer;
import com.novell.ldap.util.ValueXMLhandler;
/**
* Represents a DIT (Directory Information Tree) content rule
* in a directory schema.
*
* The LDAPDITContentRuleSchema class is used to discover or modify
* additional auxiliary classes, mandatory and optional attributes, and
* restricted attributes in effect for an object class.
*/
public class LDAPDITContentRuleSchema
extends LDAPSchemaElement
{
private String[] auxiliary = {""};
private String[] required = {""};
private String[] optional = {""};
private String[] precluded = {""};
/**
* This constructor was added to support default Serialization
*
*/
public LDAPDITContentRuleSchema()
{
super(LDAPSchema.schemaTypeNames[LDAPSchema.DITCONTENT]);
}
/**
* Constructs a DIT content rule for adding to or deleting from the
* schema.
*
* @param names The names of the content rule.
*
* @param oid The unique object identifier of the content rule -
* in dotted numerical format.
*
* @param description The optional description of the content rule.
*
* @param obsolete True if the content rule is obsolete.
*
* @param auxiliary A list of auxiliary object classes allowed for
* an entry to which this content rule applies.
* These may either be specified by name or
* numeric oid.
*
* @param required A list of attributes that an entry
* to which this content rule applies must
* contain in addition to its normal set of
* mandatory attributes. These attributes may be
* specified by either name or numeric oid.
*
* @param optional A list of attributes that an entry
* to which this content rule applies may contain
* in addition to its normal set of optional
* attributes. These attributes may be specified by
* either name or numeric oid.
*
* @param precluded A list, consisting of a subset of the optional
* attributes of the structural and
* auxiliary object classes which are precluded
* from an entry to which this content rule
* applies. These may be specified by either name
* or numeric oid.
*/
public LDAPDITContentRuleSchema(String[] names,
String oid,
String description,
boolean obsolete,
String[] auxiliary,
String[] required,
String[] optional,
String[] precluded )
{
super(LDAPSchema.schemaTypeNames[LDAPSchema.DITCONTENT]);
super.names = (String[]) names.clone();
super.oid = oid;
super.description = description;
super.obsolete = obsolete;
this.auxiliary = auxiliary;
this.required = required;
this.optional = optional;
this.precluded = precluded;
super.setValue(formatString());
return;
}
/**
* Constructs a DIT content rule from the raw string value returned from a
* schema query for dITContentRules.
*
* @param raw The raw string value returned from a schema query
* for content rules.
*/
public LDAPDITContentRuleSchema(String raw)
{
super(LDAPSchema.schemaTypeNames[LDAPSchema.DITCONTENT]);
super.obsolete = false;
try{
SchemaParser parser = new SchemaParser( raw );
if( parser.getNames() != null)
super.names = (String[])parser.getNames().clone();
if( parser.getID() != null)
super.oid = parser.getID();
if( parser.getDescription() != null)
super.description = parser.getDescription();
if( parser.getAuxiliary() != null)
auxiliary = (String[])parser.getAuxiliary().clone();
if( parser.getRequired() != null)
required = (String[])parser.getRequired().clone();
if( parser.getOptional() != null)
optional = (String[])parser.getOptional().clone();
if( parser.getPrecluded() != null)
precluded = (String[])parser.getPrecluded().clone();
super.obsolete = parser.getObsolete();
Enumeration qualifiers = parser.getQualifiers();
AttributeQualifier attrQualifier;
while(qualifiers.hasMoreElements()){
attrQualifier = (AttributeQualifier) qualifiers.nextElement();
setQualifier(attrQualifier.getName(), attrQualifier.getValues());
}
super.setValue(formatString());
}
catch( IOException e){
}
return;
}
/**
* Returns the list of allowed auxiliary classes.
*
* @return The list of allowed auxiliary classes.
*/
public String[] getAuxiliaryClasses()
{
return auxiliary;
}
/**
* Returns the list of additional required attributes for an entry
* controlled by this content rule.
*
* @return The list of additional required attributes.
*/
public String[] getRequiredAttributes()
{
return required;
}
/**
* Returns the list of additional optional attributes for an entry
* controlled by this content rule.
*
* @return The list of additional optional attributes.
*/
public String[] getOptionalAttributes()
{
return optional;
}
/**
* Returns the list of precluded attributes for an entry controlled by
* this content rule.
*
* @return The list of precluded attributes.
*/
public String[] getPrecludedAttributes()
{
return precluded;
}
/**
* Returns a string in a format suitable for directly adding to a
* directory, as a value of the particular schema element class.
*
* @return A string representation of the class' definition.
*/
protected String formatString()
{
StringBuffer valueBuffer = new StringBuffer("( ");
String token;
String[] strArray;
if( (token = getID()) != null){
valueBuffer.append(token);
}
strArray = getNames();
if( strArray != null){
valueBuffer.append(" NAME ");
if (strArray.length == 1){
valueBuffer.append("'" + strArray[0] + "'");
}
else {
valueBuffer.append("( ");
for( int i = 0; i < strArray.length; i++ ){
valueBuffer.append(" '" + strArray[i] + "'");
}
valueBuffer.append(" )");
}
}
if( (token = getDescription()) != null){
valueBuffer.append(" DESC ");
valueBuffer.append("'" + token + "'");
}
if( isObsolete()){
valueBuffer.append(" OBSOLETE");
}
if( (strArray = getAuxiliaryClasses()) != null){
valueBuffer.append(" AUX ");
if( strArray.length > 1)
valueBuffer.append("( ");
for(int i = 0; i < strArray.length; i++){
if( i > 0)
valueBuffer.append(" $ ");
valueBuffer.append(strArray[i]);
}
if( strArray.length > 1)
valueBuffer.append(" )");
}
if( (strArray = getRequiredAttributes()) != null){
valueBuffer.append(" MUST ");
if( strArray.length > 1)
valueBuffer.append("( ");
for( int i =0; i < strArray.length; i++){
if( i > 0)
valueBuffer.append(" $ ");
valueBuffer.append(strArray[i]);
}
if( strArray.length > 1)
valueBuffer.append(" )");
}
if( (strArray = getOptionalAttributes()) != null){
valueBuffer.append(" MAY ");
if( strArray.length > 1)
valueBuffer.append("( ");
for( int i =0; i < strArray.length; i++){
if( i > 0)
valueBuffer.append(" $ ");
valueBuffer.append(strArray[i]);
}
if( strArray.length > 1)
valueBuffer.append(" )");
}
if( (strArray = getPrecludedAttributes()) != null){
valueBuffer.append(" NOT ");
if( strArray.length > 1)
valueBuffer.append("( ");
for( int i =0; i < strArray.length; i++){
if( i > 0)
valueBuffer.append(" $ ");
valueBuffer.append(strArray[i]);
}
if( strArray.length > 1)
valueBuffer.append(" )");
}
Enumeration en;
if( (en = getQualifierNames()) != null){
String qualName;
String[] qualValue;
while( en.hasMoreElements() ) {
qualName = (String)en.nextElement();
valueBuffer.append( " " + qualName + " ");
if((qualValue = getQualifier( qualName )) != null){
if( qualValue.length > 1)
valueBuffer.append("( ");
for(int i = 0; i < qualValue.length; i++ ){
if( i > 0 )
valueBuffer.append(" ");
valueBuffer.append( "'" + qualValue[i] + "'");
}
if( qualValue.length > 1)
valueBuffer.append(" )");
}
}
}
valueBuffer.append(" )");
return valueBuffer.toString();
}
protected void setDeserializedValues(BufferedInputStream istream)
throws IOException {
LDAPDITContentRuleSchema readObject =
(LDAPDITContentRuleSchema)LDAPDITContentRuleSchema.readDSML(istream);
// super classes properties
this.oid = readObject.getID();
this.names = readObject.getNames();
this.description = readObject.getDescription();
this.obsolete = readObject.isObsolete();
Enumeration enumer = readObject.getQualifierNames();
while(enumer.hasMoreElements()){
String xname = (String)enumer.nextElement();
String[] qualifierVals = readObject.getQualifier(xname);
this.setQualifier(xname, qualifierVals);
}
super.setValue(formatString());
//class specific properties
this.auxiliary = readObject.getAuxiliaryClasses();
this.required = readObject.getRequiredAttributes();
this.optional = readObject.getOptionalAttributes();
this.precluded = readObject.getPrecludedAttributes();
//Garbage collect the readObject from readDSML()..
readObject = null;
}
//Overloaded function for DSML..
protected void writeValue(java.io.Writer out) throws IOException {
String value = formatString();
out.write(ValueXMLhandler.newLine(2));
out.write("");
out.write(value);
out.write(" ");
}
protected void writeValue(StringBuffer buff){
String value = formatString();
buff.append(ValueXMLhandler.newLine(2));
buff.append("");
buff.append(value);
buff.append(" ");
}
/**
* This method is used to deserialize the DSML encoded representation of
* this class.
* @param input InputStream for the DSML formatted data.
* @return Deserialized form of this class.
* @throws IOException when serialization fails.
*/
public static Object readDSML(InputStream input)throws IOException
{
SAXEventMultiplexer xmlreader = new SAXEventMultiplexer();
xmlreader.setLDAPXMLHandler(getTopXMLHandler("LDAPAttribute",null));
return (LDAPDITContentRuleSchema) xmlreader.parseXML(input);
}
//This is added to fix the bug in parsing logic written in
//getXMLHandler() method of this class
private static LDAPXMLHandler getTopXMLHandler(String tagname,LDAPXMLHandler parenthandler) {
return new LDAPXMLHandler(tagname, parenthandler) {
java.util.List valuelist = new ArrayList();
protected void initHandler() {
//set LDAPAttribute handler.
setchildelement(LDAPDITContentRuleSchema.getXMLHandler("attr",this));
}
protected void endElement() {
setObject((LDAPDITContentRuleSchema)valuelist.get(0));
}
protected void addValue(String tag, Object value) {
if (tag.equals("attr")) {
valuelist.add(value);
}
}
};
}
/**
* This method return the LDAPHandler which handles the XML (DSML) tags
* for this class
* @param tagname Name of the Root tag used to represent this class.
* @param parenthandler Parent LDAPXMLHandler for this tag.
* @return LDAPXMLHandler to handle this element.
*/
static LDAPXMLHandler getXMLHandler(String tagname,LDAPXMLHandler parenthandler)
{
return new LDAPXMLHandler(tagname,parenthandler){
String attrName;
java.util.List valuelist= new ArrayList();
protected void initHandler() {
//set value handler.
setchildelement(new ValueXMLhandler(this));
}
protected void endElement() {
Iterator valueiterator = valuelist.iterator();
LDAPDITContentRuleSchema attr = new LDAPDITContentRuleSchema(attrName);
byte[] temp = (byte[])valueiterator.next();
StringBuffer bf = new StringBuffer(temp.length);
for(int i=0; i < temp.length; i++)
bf.append((char)temp[i]);
try {
SchemaParser parser = new SchemaParser(bf.toString());
if( parser.getNames() != null)
attr.names = (String[])parser.getNames().clone();
if( parser.getID() != null)
attr.oid = parser.getID();
if( parser.getDescription() != null)
attr.description = parser.getDescription();
if( parser.getAuxiliary() != null)
attr.auxiliary = (String[])parser.getAuxiliary().clone();
if( parser.getRequired() != null)
attr.required = (String[])parser.getRequired().clone();
if( parser.getOptional() != null)
attr.optional = (String[])parser.getOptional().clone();
if( parser.getPrecluded() != null)
attr.precluded = (String[])parser.getPrecluded().clone();
attr.obsolete = parser.getObsolete();
Enumeration qualifiers = parser.getQualifiers();
AttributeQualifier attrQualifier;
while(qualifiers.hasMoreElements()){
attrQualifier = (AttributeQualifier) qualifiers.nextElement();
attr.setQualifier(attrQualifier.getName(), attrQualifier.getValues());
}
attr.setValue(attr.formatString());
} catch( IOException e) {
throw new RuntimeException(e.toString());
}
setObject(attr);
valuelist.clear();
}
protected void addValue(String tag,Object value)
{
if (tag.equals("value"))
{
valuelist.add(value);
}
}
protected void handleAttributes(Attributes attributes)throws SAXException {
attrName = attributes.getValue("name");
if (attrName== null)
throw new SAXException("invalid attr Tag, name is mandatory element: ");
}
};
}
}