ClassPropertyDefinition.java revision bccd35904bb6c244e7eae5b7ddb28e5c295e856b
/*
* 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 2008 Sun Microsystems, Inc.
* Portions copyright 2013 ForgeRock AS.
*/
/**
* Class property definition.
* <p>
* A class property definition defines a property whose values represent a Java
* class. It is possible to restrict the type of java class by specifying
* "instance of" constraints.
* <p>
* of validating the Java class (e.g. it will not be able to load it nor have
* access to the interfaces it is supposed to implement). For this reason, it is
* possible to switch off validation in the client by using the appropriate
* {@link PropertyDefinitionsOptions}.
*/
/**
* An interface for incrementally constructing class property definitions.
*/
// List of interfaces which property values must implement.
// Private constructor
super(d, propertyName);
}
/**
* Add an class name which property values must implement.
*
* @param className
* The name of a class which property values must implement.
*/
/*
* Do some basic checks to make sure the string representation is
* valid.
*/
}
}
/**
* {@inheritDoc}
*/
protected ClassPropertyDefinition buildInstance(AbstractManagedObjectDefinition<?, ?> d, String propertyName,
}
}
// Regular expression for validating class names.
private static final String CLASS_RE = "^([A-Za-z][A-Za-z0-9_]*\\.)*[A-Za-z][A-Za-z0-9_]*(\\$[A-Za-z0-9_]+)*$";
/**
* Create a class property definition builder.
*
* @param d
* The managed object definition associated with this property
* definition.
* @param propertyName
* The property name.
* @return Returns the new class property definition builder.
*/
return new Builder(d, propertyName);
}
// Load a named class.
private static Class<?> loadClass(String className, boolean initialize) throws ClassNotFoundException {
}
// List of interfaces which property values must implement.
// Private constructor.
this.instanceOfInterfaces = Collections.unmodifiableList(new LinkedList<String>(instanceOfInterfaces));
}
/**
* {@inheritDoc}
*/
public <R, P> R accept(PropertyDefinitionVisitor<R, P> v, P p) {
return v.visitClass(this, p);
}
/**
* {@inheritDoc}
*/
return v.visitClass(this, value, p);
}
/**
* {@inheritDoc}
*/
try {
} catch (IllegalPropertyValueException e) {
}
return value;
}
/**
* Get an unmodifiable list of classes which values of this property must
* implement.
*
* @return Returns an unmodifiable list of classes which values of this
* property must implement.
*/
return instanceOfInterfaces;
}
/**
* Validate and load the named class, and cast it to a subclass of the
* specified class.
*
* @param <T>
* The requested type.
* @param className
* The name of the class to validate and load.
* @param instanceOf
* The class representing the requested type.
* @return Returns the named class cast to a subclass of the specified
* class.
* @throws IllegalPropertyValueException
* If the named class was invalid, could not be loaded, or did
* not implement the required interfaces.
* @throws ClassCastException
* If the referenced class does not implement the requested
* type.
*/
// Make sure that the named class is valid.
// Cast it to the required type.
}
/**
* {@inheritDoc}
*/
}
/**
* {@inheritDoc}
*/
// Always make sure the name is a valid class name.
/*
* If additional validation is enabled then attempt to load the class
* and check the interfaces that it implements/extends.
*/
if (options.allowClassValidation()) {
validateClassInterfaces(value, false);
}
}
/*
* Do some basic checks to make sure the string representation is valid.
*/
throw new IllegalPropertyValueException(this, className);
}
}
/*
* Make sure that named class implements the interfaces named by this
* definition.
*/
for (String i : instanceOfInterfaces) {
throw new IllegalPropertyValueException(this, className);
}
}
return theClass;
}
private Class<?> loadClassForValidation(String componentClassName, String classToBeLoaded, boolean initialize) {
try {
} catch (ClassNotFoundException e) {
// If the class cannot be loaded then it is an invalid value.
throw new IllegalPropertyValueException(this, componentClassName, e);
} catch (LinkageError e) {
// If the class cannot be initialized then it is an invalid value.
throw new IllegalPropertyValueException(this, componentClassName, e);
}
}
}