|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object net.sf.ldaptemplate.support.DirContextAdapter
Implements the interesting methods of the DirContext interface. In particular
it contains utility methods for getting and setting Attributes. Using the
DefaultDirObjectFactory
in your
ContextSource you may receive instances of this class from searches and
lookups. This can be particularly useful when updating data, since this class
implements AttributeModificationsAware
,
providing a getModificationItems()
method.
Field Summary |
Fields inherited from interface javax.naming.directory.DirContext |
ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE |
Fields inherited from interface javax.naming.Context |
APPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES |
Constructor Summary | |
|
DirContextAdapter()
Default constructor. |
|
DirContextAdapter(javax.naming.directory.Attributes pAttrs,
javax.naming.Name dn)
Create a new entry from the supplied attributes and dn. |
protected |
DirContextAdapter(DirContextAdapter master)
Constructor for cloning an existing entry. |
|
DirContextAdapter(javax.naming.Name dn)
|
Method Summary | |
java.lang.Object |
addToEnvironment(java.lang.String propName,
java.lang.Object propVal)
|
void |
bind(javax.naming.Name name,
java.lang.Object obj)
|
void |
bind(javax.naming.Name name,
java.lang.Object obj,
javax.naming.directory.Attributes attrs)
|
void |
bind(java.lang.String name,
java.lang.Object obj)
|
void |
bind(java.lang.String name,
java.lang.Object obj,
javax.naming.directory.Attributes attrs)
|
void |
close()
|
javax.naming.Name |
composeName(javax.naming.Name name,
javax.naming.Name prefix)
|
java.lang.String |
composeName(java.lang.String name,
java.lang.String prefix)
|
javax.naming.Context |
createSubcontext(javax.naming.Name name)
|
javax.naming.directory.DirContext |
createSubcontext(javax.naming.Name name,
javax.naming.directory.Attributes attrs)
|
javax.naming.Context |
createSubcontext(java.lang.String name)
|
javax.naming.directory.DirContext |
createSubcontext(java.lang.String name,
javax.naming.directory.Attributes attrs)
|
void |
destroySubcontext(javax.naming.Name name)
|
void |
destroySubcontext(java.lang.String name)
|
boolean |
equals(java.lang.Object obj)
|
protected boolean |
exists(javax.naming.directory.Attribute attr)
Checks if an entry has a specific attribute. |
protected boolean |
exists(java.lang.String attrId)
Checks if the attribute exists in this entry, either it was read or it has been added and update() has been called. |
javax.naming.directory.Attributes |
getAttributes()
Get all attributes. |
javax.naming.directory.Attributes |
getAttributes(javax.naming.Name name)
|
javax.naming.directory.Attributes |
getAttributes(javax.naming.Name name,
java.lang.String[] attrIds)
|
javax.naming.directory.Attributes |
getAttributes(java.lang.String name)
|
javax.naming.directory.Attributes |
getAttributes(java.lang.String name,
java.lang.String[] attrIds)
|
java.util.SortedSet |
getAttributeSortedStringSet(java.lang.String name)
Get all String values of the attribute as a SortedSet. |
javax.naming.Name |
getDn()
Returns DN, for example uid=some.user,ou=People,ou=EU . |
java.util.Hashtable |
getEnvironment()
|
NamingExceptionTranslator |
getExceptionTranslator()
Get the NamingExceptionTranslator. |
javax.naming.directory.ModificationItem[] |
getModificationItems()
Creates an array of which attributes have been changed or added. |
java.lang.String |
getNameInNamespace()
|
javax.naming.NameParser |
getNameParser(javax.naming.Name name)
|
javax.naming.NameParser |
getNameParser(java.lang.String name)
|
java.lang.String[] |
getNamesOfModifiedAttributes()
Creates a String array of the names of the attributes which have been changed. |
java.lang.Object |
getObjectAttribute(java.lang.String name)
Get the value of an Object attribute. |
javax.naming.directory.DirContext |
getSchema(javax.naming.Name name)
|
javax.naming.directory.DirContext |
getSchema(java.lang.String name)
|
javax.naming.directory.DirContext |
getSchemaClassDefinition(javax.naming.Name name)
|
javax.naming.directory.DirContext |
getSchemaClassDefinition(java.lang.String name)
|
java.lang.String |
getStringAttribute(java.lang.String name)
Get the value of a String attribute. |
java.lang.String[] |
getStringAttributes(java.lang.String name)
Get all values of a String attribute. |
int |
hashCode()
|
boolean |
isUpdateMode()
Gets the update mode. |
javax.naming.NamingEnumeration |
list(javax.naming.Name name)
|
javax.naming.NamingEnumeration |
list(java.lang.String name)
|
javax.naming.NamingEnumeration |
listBindings(javax.naming.Name name)
|
javax.naming.NamingEnumeration |
listBindings(java.lang.String name)
|
java.lang.Object |
lookup(javax.naming.Name name)
|
java.lang.Object |
lookup(java.lang.String name)
|
java.lang.Object |
lookupLink(javax.naming.Name name)
|
java.lang.Object |
lookupLink(java.lang.String name)
|
void |
modifyAttributes(javax.naming.Name name,
int modOp,
javax.naming.directory.Attributes attrs)
|
void |
modifyAttributes(javax.naming.Name name,
javax.naming.directory.ModificationItem[] mods)
|
void |
modifyAttributes(java.lang.String name,
int modOp,
javax.naming.directory.Attributes attrs)
|
void |
modifyAttributes(java.lang.String name,
javax.naming.directory.ModificationItem[] mods)
|
void |
rebind(javax.naming.Name name,
java.lang.Object obj)
|
void |
rebind(javax.naming.Name name,
java.lang.Object obj,
javax.naming.directory.Attributes attrs)
|
void |
rebind(java.lang.String name,
java.lang.Object obj)
|
void |
rebind(java.lang.String name,
java.lang.Object obj,
javax.naming.directory.Attributes attrs)
|
java.lang.Object |
removeFromEnvironment(java.lang.String propName)
|
void |
rename(javax.naming.Name oldName,
javax.naming.Name newName)
|
void |
rename(java.lang.String oldName,
java.lang.String newName)
|
javax.naming.NamingEnumeration |
search(javax.naming.Name name,
javax.naming.directory.Attributes matchingAttributes)
|
javax.naming.NamingEnumeration |
search(javax.naming.Name name,
javax.naming.directory.Attributes matchingAttributes,
java.lang.String[] attributesToReturn)
|
javax.naming.NamingEnumeration |
search(javax.naming.Name name,
java.lang.String filterExpr,
java.lang.Object[] filterArgs,
javax.naming.directory.SearchControls cons)
|
javax.naming.NamingEnumeration |
search(javax.naming.Name name,
java.lang.String filter,
javax.naming.directory.SearchControls cons)
|
javax.naming.NamingEnumeration |
search(java.lang.String name,
javax.naming.directory.Attributes matchingAttributes)
|
javax.naming.NamingEnumeration |
search(java.lang.String name,
javax.naming.directory.Attributes matchingAttributes,
java.lang.String[] attributesToReturn)
|
javax.naming.NamingEnumeration |
search(java.lang.String name,
java.lang.String filterExpr,
java.lang.Object[] filterArgs,
javax.naming.directory.SearchControls cons)
|
javax.naming.NamingEnumeration |
search(java.lang.String name,
java.lang.String filter,
javax.naming.directory.SearchControls cons)
|
void |
setAttribute(javax.naming.directory.Attribute attribute)
Set the supplied attribute. |
void |
setAttributeValue(java.lang.String name,
java.lang.Object value)
Set the with the name name to the value . |
void |
setAttributeValues(java.lang.String name,
java.lang.Object[] values)
Sets a multivalue attribute, disregarding the order of the values. |
void |
setAttributeValues(java.lang.String name,
java.lang.Object[] values,
boolean orderMatters)
Sets a multivalue attribute. |
void |
setDn(javax.naming.Name dn)
Set the dn of this entry. |
void |
setExceptionTranslator(NamingExceptionTranslator exceptionTranslator)
Set the NamingExceptionTranslator to use. |
protected void |
setUpdateMode(boolean mode)
Sets the update mode. |
java.lang.String |
toString()
|
void |
unbind(javax.naming.Name name)
|
void |
unbind(java.lang.String name)
|
void |
update()
Update the attributes. |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public DirContextAdapter()
public DirContextAdapter(javax.naming.Name dn)
public DirContextAdapter(javax.naming.directory.Attributes pAttrs, javax.naming.Name dn)
pAttrs
- the attributes.dn
- the dn.protected DirContextAdapter(DirContextAdapter master)
master
- The object to be copied.Method Detail |
protected void setUpdateMode(boolean mode)
false
for
a new entry and true
for an existing entry that is being
updated.
mode
- Update mode.public boolean isUpdateMode()
DirContextOperations
true
for a
new entry and true
for an existing entry that is being
updated.
isUpdateMode
in interface DirContextOperations
public java.lang.String[] getNamesOfModifiedAttributes()
DirContextOperations
getNamesOfModifiedAttributes
in interface DirContextOperations
public javax.naming.directory.ModificationItem[] getModificationItems()
AttributeModificationsAware
getModificationItems
in interface AttributeModificationsAware
protected final boolean exists(javax.naming.directory.Attribute attr)
attr
- the attribute to check.
protected final boolean exists(java.lang.String attrId)
attrId
- id of the attribute to check.
public java.lang.String getStringAttribute(java.lang.String name)
DirContextOperations
getStringAttribute
in interface DirContextOperations
name
- name of the attribute.
public java.lang.Object getObjectAttribute(java.lang.String name)
DirContextOperations
getObjectAttribute
in interface DirContextOperations
name
- name of the attribute.
null
otherwise.public void setAttributeValue(java.lang.String name, java.lang.Object value)
DirContextOperations
name
to the value
.
setAttributeValue
in interface DirContextOperations
name
- name of the attribute.value
- value to set the attribute to.public void setAttributeValues(java.lang.String name, java.lang.Object[] values)
DirContextOperations
setAttributeValues
in interface DirContextOperations
name
- The id of the attribute.values
- Attribute values.public void setAttributeValues(java.lang.String name, java.lang.Object[] values, boolean orderMatters)
DirContextOperations
setAttributeValues
in interface DirContextOperations
name
- The id of the attribute.values
- Attribute values.orderMatters
- If true
, it will be changed even if data was
just reordered.public void update()
DirContextOperations
update
in interface DirContextOperations
public java.lang.String[] getStringAttributes(java.lang.String name)
DirContextOperations
getStringAttributes
in interface DirContextOperations
name
- name of the attribute.
public java.util.SortedSet getAttributeSortedStringSet(java.lang.String name)
DirContextOperations
getAttributeSortedStringSet
in interface DirContextOperations
name
- name of the attribute.
public void setAttribute(javax.naming.directory.Attribute attribute)
attribute
- the attribute to set.public javax.naming.directory.Attributes getAttributes()
public javax.naming.directory.Attributes getAttributes(javax.naming.Name name) throws javax.naming.NamingException
getAttributes
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.getAttributes(Name)
public javax.naming.directory.Attributes getAttributes(java.lang.String name) throws javax.naming.NamingException
getAttributes
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.getAttributes(String)
public javax.naming.directory.Attributes getAttributes(javax.naming.Name name, java.lang.String[] attrIds) throws javax.naming.NamingException
getAttributes
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.getAttributes(Name, String[])
public javax.naming.directory.Attributes getAttributes(java.lang.String name, java.lang.String[] attrIds) throws javax.naming.NamingException
getAttributes
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.getAttributes(String, String[])
public void modifyAttributes(javax.naming.Name name, int modOp, javax.naming.directory.Attributes attrs) throws javax.naming.NamingException
modifyAttributes
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.modifyAttributes(javax.naming.Name,
int, javax.naming.directory.Attributes)
public void modifyAttributes(java.lang.String name, int modOp, javax.naming.directory.Attributes attrs) throws javax.naming.NamingException
modifyAttributes
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.modifyAttributes(String, int,
Attributes)
public void modifyAttributes(javax.naming.Name name, javax.naming.directory.ModificationItem[] mods) throws javax.naming.NamingException
modifyAttributes
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.modifyAttributes(Name,
ModificationItem[])
public void modifyAttributes(java.lang.String name, javax.naming.directory.ModificationItem[] mods) throws javax.naming.NamingException
modifyAttributes
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.modifyAttributes(String,
ModificationItem[])
public void bind(javax.naming.Name name, java.lang.Object obj, javax.naming.directory.Attributes attrs) throws javax.naming.NamingException
bind
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.bind(Name, Object, Attributes)
public void bind(java.lang.String name, java.lang.Object obj, javax.naming.directory.Attributes attrs) throws javax.naming.NamingException
bind
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.bind(String, Object, Attributes)
public void rebind(javax.naming.Name name, java.lang.Object obj, javax.naming.directory.Attributes attrs) throws javax.naming.NamingException
rebind
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.rebind(Name, Object, Attributes)
public void rebind(java.lang.String name, java.lang.Object obj, javax.naming.directory.Attributes attrs) throws javax.naming.NamingException
rebind
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.rebind(String, Object, Attributes)
public javax.naming.directory.DirContext createSubcontext(javax.naming.Name name, javax.naming.directory.Attributes attrs) throws javax.naming.NamingException
createSubcontext
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.createSubcontext(Name, Attributes)
public javax.naming.directory.DirContext createSubcontext(java.lang.String name, javax.naming.directory.Attributes attrs) throws javax.naming.NamingException
createSubcontext
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.createSubcontext(String,
Attributes)
public javax.naming.directory.DirContext getSchema(javax.naming.Name name) throws javax.naming.NamingException
getSchema
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.getSchema(Name)
public javax.naming.directory.DirContext getSchema(java.lang.String name) throws javax.naming.NamingException
getSchema
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.getSchema(String)
public javax.naming.directory.DirContext getSchemaClassDefinition(javax.naming.Name name) throws javax.naming.NamingException
getSchemaClassDefinition
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.getSchemaClassDefinition(Name)
public javax.naming.directory.DirContext getSchemaClassDefinition(java.lang.String name) throws javax.naming.NamingException
getSchemaClassDefinition
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.getSchemaClassDefinition(String)
public javax.naming.NamingEnumeration search(javax.naming.Name name, javax.naming.directory.Attributes matchingAttributes, java.lang.String[] attributesToReturn) throws javax.naming.NamingException
search
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.search(Name, Attributes, String[])
public javax.naming.NamingEnumeration search(java.lang.String name, javax.naming.directory.Attributes matchingAttributes, java.lang.String[] attributesToReturn) throws javax.naming.NamingException
search
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.search(String, Attributes,
String[])
public javax.naming.NamingEnumeration search(javax.naming.Name name, javax.naming.directory.Attributes matchingAttributes) throws javax.naming.NamingException
search
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.search(Name, Attributes)
public javax.naming.NamingEnumeration search(java.lang.String name, javax.naming.directory.Attributes matchingAttributes) throws javax.naming.NamingException
search
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.search(String, Attributes)
public javax.naming.NamingEnumeration search(javax.naming.Name name, java.lang.String filter, javax.naming.directory.SearchControls cons) throws javax.naming.NamingException
search
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.search(Name, String,
SearchControls)
public javax.naming.NamingEnumeration search(java.lang.String name, java.lang.String filter, javax.naming.directory.SearchControls cons) throws javax.naming.NamingException
search
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.search(String, String,
SearchControls)
public javax.naming.NamingEnumeration search(javax.naming.Name name, java.lang.String filterExpr, java.lang.Object[] filterArgs, javax.naming.directory.SearchControls cons) throws javax.naming.NamingException
search
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.search(Name, String, Object[],
SearchControls)
public javax.naming.NamingEnumeration search(java.lang.String name, java.lang.String filterExpr, java.lang.Object[] filterArgs, javax.naming.directory.SearchControls cons) throws javax.naming.NamingException
search
in interface javax.naming.directory.DirContext
javax.naming.NamingException
DirContext.search(String, String, Object[],
SearchControls)
public java.lang.Object lookup(javax.naming.Name name) throws javax.naming.NamingException
lookup
in interface javax.naming.Context
javax.naming.NamingException
Context.lookup(Name)
public java.lang.Object lookup(java.lang.String name) throws javax.naming.NamingException
lookup
in interface javax.naming.Context
javax.naming.NamingException
Context.lookup(String)
public void bind(javax.naming.Name name, java.lang.Object obj) throws javax.naming.NamingException
bind
in interface javax.naming.Context
javax.naming.NamingException
Context.bind(Name, Object)
public void bind(java.lang.String name, java.lang.Object obj) throws javax.naming.NamingException
bind
in interface javax.naming.Context
javax.naming.NamingException
Context.bind(String, Object)
public void rebind(javax.naming.Name name, java.lang.Object obj) throws javax.naming.NamingException
rebind
in interface javax.naming.Context
javax.naming.NamingException
Context.rebind(Name, Object)
public void rebind(java.lang.String name, java.lang.Object obj) throws javax.naming.NamingException
rebind
in interface javax.naming.Context
javax.naming.NamingException
Context.rebind(String, Object)
public void unbind(javax.naming.Name name) throws javax.naming.NamingException
unbind
in interface javax.naming.Context
javax.naming.NamingException
Context.unbind(Name)
public void unbind(java.lang.String name) throws javax.naming.NamingException
unbind
in interface javax.naming.Context
javax.naming.NamingException
Context.unbind(String)
public void rename(javax.naming.Name oldName, javax.naming.Name newName) throws javax.naming.NamingException
rename
in interface javax.naming.Context
javax.naming.NamingException
Context.rename(Name, Name)
public void rename(java.lang.String oldName, java.lang.String newName) throws javax.naming.NamingException
rename
in interface javax.naming.Context
javax.naming.NamingException
Context.rename(String, String)
public javax.naming.NamingEnumeration list(javax.naming.Name name) throws javax.naming.NamingException
list
in interface javax.naming.Context
javax.naming.NamingException
Context.list(Name)
public javax.naming.NamingEnumeration list(java.lang.String name) throws javax.naming.NamingException
list
in interface javax.naming.Context
javax.naming.NamingException
Context.list(String)
public javax.naming.NamingEnumeration listBindings(javax.naming.Name name) throws javax.naming.NamingException
listBindings
in interface javax.naming.Context
javax.naming.NamingException
Context.listBindings(Name)
public javax.naming.NamingEnumeration listBindings(java.lang.String name) throws javax.naming.NamingException
listBindings
in interface javax.naming.Context
javax.naming.NamingException
Context.listBindings(String)
public void destroySubcontext(javax.naming.Name name) throws javax.naming.NamingException
destroySubcontext
in interface javax.naming.Context
javax.naming.NamingException
Context.destroySubcontext(Name)
public void destroySubcontext(java.lang.String name) throws javax.naming.NamingException
destroySubcontext
in interface javax.naming.Context
javax.naming.NamingException
Context.destroySubcontext(String)
public javax.naming.Context createSubcontext(javax.naming.Name name) throws javax.naming.NamingException
createSubcontext
in interface javax.naming.Context
javax.naming.NamingException
Context.createSubcontext(Name)
public javax.naming.Context createSubcontext(java.lang.String name) throws javax.naming.NamingException
createSubcontext
in interface javax.naming.Context
javax.naming.NamingException
Context.createSubcontext(String)
public java.lang.Object lookupLink(javax.naming.Name name) throws javax.naming.NamingException
lookupLink
in interface javax.naming.Context
javax.naming.NamingException
Context.lookupLink(Name)
public java.lang.Object lookupLink(java.lang.String name) throws javax.naming.NamingException
lookupLink
in interface javax.naming.Context
javax.naming.NamingException
Context.lookupLink(String)
public javax.naming.NameParser getNameParser(javax.naming.Name name) throws javax.naming.NamingException
getNameParser
in interface javax.naming.Context
javax.naming.NamingException
Context.getNameParser(Name)
public javax.naming.NameParser getNameParser(java.lang.String name) throws javax.naming.NamingException
getNameParser
in interface javax.naming.Context
javax.naming.NamingException
Context.getNameParser(String)
public javax.naming.Name composeName(javax.naming.Name name, javax.naming.Name prefix) throws javax.naming.NamingException
composeName
in interface javax.naming.Context
javax.naming.NamingException
Context.composeName(Name, Name)
public java.lang.String composeName(java.lang.String name, java.lang.String prefix) throws javax.naming.NamingException
composeName
in interface javax.naming.Context
javax.naming.NamingException
Context.composeName(String, String)
public java.lang.Object addToEnvironment(java.lang.String propName, java.lang.Object propVal) throws javax.naming.NamingException
addToEnvironment
in interface javax.naming.Context
javax.naming.NamingException
Context.addToEnvironment(String, Object)
public java.lang.Object removeFromEnvironment(java.lang.String propName) throws javax.naming.NamingException
removeFromEnvironment
in interface javax.naming.Context
javax.naming.NamingException
Context.removeFromEnvironment(String)
public java.util.Hashtable getEnvironment() throws javax.naming.NamingException
getEnvironment
in interface javax.naming.Context
javax.naming.NamingException
Context.getEnvironment()
public void close() throws javax.naming.NamingException
close
in interface javax.naming.Context
javax.naming.NamingException
Context.close()
public java.lang.String getNameInNamespace()
getNameInNamespace
in interface javax.naming.Context
Context.getNameInNamespace()
public javax.naming.Name getDn()
DirContextOperations
uid=some.user,ou=People,ou=EU
.
getDn
in interface DirContextOperations
getNameInNamespace()
public final void setDn(javax.naming.Name dn)
DirContextOperations
setDn
in interface DirContextOperations
dn
- the dn.public boolean equals(java.lang.Object obj)
Object.equals(java.lang.Object)
public int hashCode()
Object.hashCode()
public java.lang.String toString()
Object.toString()
public NamingExceptionTranslator getExceptionTranslator()
DefaultNamingExceptionTranslator
is used.public void setExceptionTranslator(NamingExceptionTranslator exceptionTranslator)
exceptionTranslator
- the NamingExceptionTranslator to use.
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |