public class LookupAttributes extends Object
Modifier and Type | Method and Description |
---|---|
static Entry[] |
add(Entry[] attrSets,
Entry[] addAttrSets)
Returns a new array containing the elements of the
addAttrSets parameter (that are not duplicates of
any of the elements already in the attrSets parameter)
added to the elements of attrSets . |
static Entry[] |
add(Entry[] attrSets,
Entry[] addAttrSets,
boolean checkSC)
Returns a new array containing the elements of the
addAttrSets parameter (that are not duplicates of
any of the elements already in the attrSets parameter)
added to the elements of attrSets . |
static void |
check(Entry[] attrs,
boolean nullOK)
Throws an
IllegalArgumentException if any element of
the array is not an instance of a valid Entry class
(the class is not public, or does not have a no-arg constructor, or
has primitive public non-static non-final fields). |
static boolean |
equal(Entry[] attrSet1,
Entry[] attrSet2)
Tests that two
Entry[] arrays are the same. |
static boolean |
equal(Entry e1,
Entry e2)
Test that two entries are the same type, with the same
public fields.
|
static boolean |
matches(Entry tmpl,
Entry e)
Test if the parameter
tmpl is the same class as, or a
superclass of, the parameter e , and that every
non-null public field of tmpl is the
same as the corresponding field of e . |
static Entry[] |
modify(Entry[] attrSets,
Entry[] attrSetTmpls,
Entry[] modAttrSets)
Returns a new array that contains copies of the attributes in the
attrSets parameter, modified according to the contents
of both the attrSetTmpls parameter and the
modAttrSets parameter. |
static Entry[] |
modify(Entry[] attrSets,
Entry[] attrSetTmpls,
Entry[] modAttrSets,
boolean checkSC)
Returns a new array that contains copies of the attributes in the
attrSets parameter, modified according to the contents
of both the attrSetTmpls parameter and the
modAttrSets parameter. |
public static Entry[] add(Entry[] attrSets, Entry[] addAttrSets)
addAttrSets
parameter (that are not duplicates of
any of the elements already in the attrSets
parameter)
added to the elements of attrSets
. The parameter
arrays are not modified.
Note that attribute equality is defined in terms of
MarshalledObject.equals
on field values. The
parameter arrays are not modified.
Throws an IllegalArgumentException
if any element of
addAttrSets
is not an instance of a valid
Entry
class (the class is not public, or does not have a
no-arg constructor, or has primitive public non-static non-final
fields).
attrSets
- original Entry attributesaddAttrSets
- Entry attributes to added if not already contained in attrSetspublic static Entry[] add(Entry[] attrSets, Entry[] addAttrSets, boolean checkSC)
addAttrSets
parameter (that are not duplicates of
any of the elements already in the attrSets
parameter)
added to the elements of attrSets
. The parameter
arrays are not modified.
Note that attribute equality is defined in terms of
MarshalledInstance.equals
on field values. The
parameter arrays are not modified.
If the checkSC
parameter is true
,
then a SecurityException
is thrown if any elements
of the addAttrSets
parameter are instanceof
ServiceControlled
.
Throws an IllegalArgumentException
if any element of
addAttrSets
is not an instance of a valid
Entry
class (the class is not public, or does not have a
no-arg constructor, or has primitive public non-static non-final
fields).
attrSets
- original Entry attributesaddAttrSets
- Entry attributes to added if not already contained in attrSetscheckSC
- if true checks for any elements of addAttrSets are instances
of ServiceControlled.public static Entry[] modify(Entry[] attrSets, Entry[] attrSetTmpls, Entry[] modAttrSets)
attrSets
parameter, modified according to the contents
of both the attrSetTmpls
parameter and the
modAttrSets
parameter. The parameter arrays and
their Entry
instances are not modified.
Throws an IllegalArgumentException
if any element of
attrSetTmpls
or modAttrSets
is not an
instance of a valid Entry
class (the class is not public,
or does not have a no-arg constructor, or has primitive public
non-static non-final fields).
attrSets
- Entry attributesattrSetTmpls
- Entry attribute templatesmodAttrSets
- Entry modified attributespublic static Entry[] modify(Entry[] attrSets, Entry[] attrSetTmpls, Entry[] modAttrSets, boolean checkSC)
attrSets
parameter, modified according to the contents
of both the attrSetTmpls
parameter and the
modAttrSets
parameter. The parameter arrays and
their Entry
instances are not modified.
If the checkSC
parameter is true
, then a
SecurityException
is thrown if any elements of the
attrSets
parameter that would be deleted or modified
are instanceof ServiceControlled
.
Throws an IllegalArgumentException
if any element of
attrSetTmpls
or modAttrSets
is not an
instance of a valid Entry
class (the class is not public,
or does not have a no-arg constructor, or has primitive public
non-static non-final fields).
attrSets
- Entry attributesattrSetTmpls
- Entry attribute templatesmodAttrSets
- Entry modified attributescheckSC
- if true checks for any elements of addAttrSets are instances
of ServiceControlled.public static boolean equal(Entry e1, Entry e2)
MarshalledObject.equals
on field values.e1
- an Entrye2
- A second Entrypublic static boolean equal(Entry[] attrSet1, Entry[] attrSet2)
Entry[]
arrays are the same.attrSet1
- first Entry array.attrSet2
- second Entry arraypublic static boolean matches(Entry tmpl, Entry e)
tmpl
is the same class as, or a
superclass of, the parameter e
, and that every
non-null
public field of tmpl
is the
same as the corresponding field of e
. Attribute equality
is defined in terms of MarshalledObject.equals
on
field values.tmpl
- Entry template.e
- Entry to be checked for template matching.public static void check(Entry[] attrs, boolean nullOK)
IllegalArgumentException
if any element of
the array is not an instance of a valid Entry
class
(the class is not public, or does not have a no-arg constructor, or
has primitive public non-static non-final fields). If
nullOK
is false
, and any element of the
array is null
, a NullPointerException
is thrown.attrs
- to be checked if valid Entry classes.nullOK
- true if array can contain null elements.Copyright 2007-2013, multiple authors.
Licensed under the Apache License, Version 2.0, see the NOTICE file for attributions.