javatm platform
standard ed. 6

javax.naming.directory
接口 attribute

所有<all>超级接口:
cloneable, serializable
所有已知实现类:
basicattribute

public interface attribute
extends cloneable, serializable

此接口表示与命名对象关联的属性。

在目录中,命名的对象可以< kě yǐ>与其属性关联。attribute 接口表示与命名对象关联的属性。属性包含 0 个或多个(可能<would>为 null 的)值。属性值可以< kě yǐ>是有序的也可以是无序的(参阅 isordered())。如果值是无序的,则不允许<allow>重复。如果值是有序的,则允许<allow>重复。

属性的内容和表示形式及其值均由属性的模式 定义。模式包含关于属性语法和属性其他<other>性质的信息。有关基础目录服务<fú wù>支持<zhī chí>模式时如何<rú hé>获取关于属性的模式信息的详细校約ense>畔ⅲ氩卧 getattributedefinition()getattributesyntaxdefinition()

两个属性的相等性由实现类确定。简单的实现可以使用 object.equals() 来确定属性值的相等性,而较复杂的实现可能<would>使用模式信息来确定相等性。类似地,一个实现可能提供仅返回传递给其构造方法的值的静态存储结构,另一个实现可能定义 get()getall() 从目录动态获取值。

注意<危险信号>,更新 attribute(如添加或移除值)对目录中相应的属性表示形式没有影响。只有使用 dircontext 接口中的操作才能实现对目录的更新。

从以下版本开始<kāi shǐ>:
1.3
另请参见:
basicattribute

字段摘要
static longserialversionuid
          使用 jndi 1.1.1 中的 serialversionuid 获取互操作性。
 
方法摘要
 voidadd(int ix,object attrval)
          将属性值添加到属性值的有序列表中。
 booleanadd(object attrval)
          向属性添加新值。
 voidclear()
          从此属性移除所有值。
 objectclone()
          对属性进行复制。
 booleanjs随机数contains(object attrval)
          确定某个值是否在属性中。
 objectget()
          检索此属性的其中一个值。
 objectget(int ix)
          从属性值的有序列表中检索属性值。
 namingenumeration<?>getall()
          检索属性值的枚举。
 dircontextgetattributedefinition()
          检索属性的模式定义。
 dircontextgetattributesyntaxdefinition()
          检索与属性关联的语法定义。
 stringgetid()
          检索此属性的 id。
 booleanisordered()
          确定此属性的值是否是有序的。
 objectremove(int ix)
          从属性值的有序列表中移除属性值。
 booleanremove(object attrval)
          从属性中移除指定值。
 objectset(int ix,object attrval)
          设置属性值的有序列表中的属性值。
 intsize()
          检索此属性中的值数。
 

字段详细信息

serialversionuid

static final long serialversionuid
使用 jndi 1.1.1 中的 serialversionuid 获取互操作性。

另请参见:
常量字段值
方法详细信息

getall

namingenumeration<?> getall()      throws namingexception
检索属性值的枚举。如果正在进行枚举时添加、更改或移除属性值,则此枚举的行为是不确定的。如果属性值是有序的,则枚举的项将是有序的。

返回:
属性值的非 null 枚举。每个枚举元素都可能是一个 null 对象。对象的类就是属性值的类。如果属性值为 null,则元素为 null。如果属性的值为零,则返回空枚举。
抛出:
namingexception - 如果检索值时遇到命名异常。
另请参见:
isordered()

get

object get()  throws namingexception
检索此属性的其中一个值。如果属性具有多个值并且是无序的,则返回其中的任意一个值。如果属性具多个值并且是有序的,则返回第一个值。

返回:
表示属性值之一的可能为 null 的对象。如果属性值为 null,则返回 null。
抛出:
namingexception - 如果检索值时遇到命名异常。
nosuchelementexception - 如果此属性没有值。
位于拥?a文创园区的星空草原,是由百万支各色的宝特瓶打造而成,不少民众去基隆一带游玩时,都会顺道拜访星空草原,并拍下缤纷的合影,特别的是,夜间点灯后,更有种萤光视觉效果,拍起来也能有另外的风格<manner>,让其被列入文青们必踩景点
这种人希望<xī wàng>和他的偶像明星<míng xīng>一样,可能是外表也可能是才华,如果是放很努力的名人,这种人可能是觉得<jué de>自己<his>感受的辛苦和那位名人一样
不过,最特别的还是Q版正义联盟形象<image>概念店,分别是位于台北金山南路的超人形象<image>店,和变装成蝙蝠侠秘密基地的高雄驳二艺术店,都各具特色
夫妻间彼此信任很重要<zhòng yào>,若其中一人妒忌心过重,很难维持一段健全的婚姻<hūn yīn>关?S,严重甚至会毁了你们的婚姻<hūn yīn>
第10名的韩国<Hán ɡuó>农心辛拉?I,在人气韩剧《太阳的后裔》的加持下,让它的买气大幅提升
如果是我选,我一定是挑右边比较明亮的这区,但其实这里的桌椅比较没那么舒服,如果只是来吃冰的话,坐在这区倒也没关?S
又来了<lai l>!继大婶爽装巡扫冰柜、推车直接推到家门口,有网友再度<attitudes>爆料指出,遇到超夸张事情<affair>,竟有人趁着顾客结帐空档,把整台推车直接推走,被发现还毫无歉意,疑似是惯犯

size

int size()
检索此属性中的值数。

返回:
此属性中的非负值数。

getid

string getid()
检索此属性的 id。

返回:
此属性的 id。它不能为 null。

contains

boolean contains(object attrval)
确定某个值是否在属性中。相等性由实现确定,其可能使用 object.equals() 或模式信息来确定相等性。

参数:
attrval - 要检查的可能为 null 的值。如果为 null,则检查属性是否具有其值不为 null 的属性值。
返回:
如果 attrval 是此属性的值之一,则返回 true;否则返回 false。
另请参见:
object.equals(java.lang.object),basicattribute.equals(java.lang.object)

add

boolean add(object attrval)
向属性添加新值。如果属性值是无序的,并且 attrval 已在属性中,则此方法不执行任何操作。如果属性值是有序的,则 attrval 将被添加到属性值列表的末尾。

相等性由实现确定,其可能使用 object.equals() 或模式信息来确定相等性。

参数:
attrval - 要添加的可能为 null 的新值。如果为 null,则将 null 作为属性值添加。
返回:
如果添加了值,则返回 true;否则返回 false。

remove

boolean remove(object attrval)
从属性中移除指定值。如果 attrval 不在属性中,则此方法不执行任何操作。如果属性值是有序的,则移除第一次出现<chū xiàn>的 attrval,大于被移除值的索引处的属性值朝列表头方向上移(并将其索引减一)。

相等性由实现确定,其可能使用 object.equals() 或模式信息来确定相等性。

参数:
attrval - 要从此属性中移除的可能为 null 的值。如果为 null,则移除为 null 的属性值。
返回:
如果移除了值,则返回 true;否则返回 false。

clear

void clear()
从此属性移除所有值。


getattributesyntaxdefinition

dircontext getattributesyntaxdefinition()        throws namingexception
检索与属性关联的语法定义。属性的语法定义指定属性值的格式。注意<危险信号>,这与作为 java 对象的属性值的表示形式不同。语法定义指的是目录的语法 概念。

例如,即使值可能为 java string 对象,其目录语法仍可能为 "printable string" 或 "telephone number"。或者值可能为字节数组,而其目录语法为 "jpeg" 或 "certificate"。例如,如果此属性的语法为 "jpeg",则此方法将返回 "jpeg" 的语法定义。

可以从语法定义检索的信息与目录有关。

如果实现不支持<zhī chí>模式,则其将抛出 operationnotsupportedexception。如果实现支持模式,则其应定义此方法以返回适当的信息。

返回:
属性的语法定义。如果实现支持模式但此特定属性不具有任何模式信息,则返回 null。
抛出:
operationnotsupportedexception - 如果不支持获取模式。
namingexception - 如果在获取模式时发生<occasionally occurred>命名异常。

getattributedefinition

dircontext getattributedefinition()       throws namingexception
检索属性的模式定义。属性的模式定义包含的信息有:属性是多值的还是单值的;比较属性值时使用哪些匹配规则<regulations>,等等。可以从属性定义检索的信息与目录有关。

如果实现不支持模式,则其将抛出 operationnotsupportedexception。如果实现支持模式,则其应定义此方法以返回适当的信息。

返回:
此属性的模式定义。如果实现支持模式但此特定属性不具有任何模式信息,则返回 null。
抛出:
operationnotsupportedexception - 如果不支持获取模式。
namingexception - 如果在获取模式时发生<occasionally occurred>命名异常。

clone

object clone()
对属性进行复制。副本包含与初始属性相同的属性值:这些属性值不是其本身的副本。对副本的更改不会影响原件,反之亦然。

返回:
属性的非 null 副本。

isordered

boolean isordered()
确定此属性的值是否是有序的。如果属性值是有序的,则允许重复的值。如果属性值是无序的,则它们以任意顺序出现<chū xiàn>,没有重复值。

返回:
如果此属性的值是有序的,则返回 true;否则返回 false。
另请参见:
get(int),remove(int),add(int, java.lang.object),set(int, java.lang.object)

get

object get(int ix)  throws namingexception
从属性值的有序列表中检索属性值。此方法返回属性值列表中 ix 索引处的值。如果属性值是无序的,则此方法返回正好位于该索引处的值。

参数:
ix - 属性值的有序列表中值的索引。0 <=ix < size()
返回:js随机数
位于索引 ix 处的可能为 null 的属性值;如果属性值为 null,则返回 null。
抛出:
namingexception - 如果检索值时遇到命名异常。
indexoutofboundsexception - 如果 ix 位于指定范围之外。

remove

object remove(int ix)
从属性值的有序列表中移除属性值。此方法移除属性值列表中 ix 索引处的值。如果属性值是无序的,则此方法移除正好位于该索引处的值。位于大于 ix 的索引处的值朝列表开头上移(并且其索引减一)。

参数:
ix - 要移除的值的索引。0 <=ix < size()
返回:
已移除的位于索引 ix 处的可能为 null 的属性值;如果属性值为 null,则返回 null。
抛出:
indexoutofboundsexception - 如果 ix 位于指定范围之外。
网站地图 手机端

add

void add(int ix,   object attrval)
将属性值添加到属性值的有序列表中。此方法将 attrval 添加到属性值列表的索引 ix 处。位于 ix 处的索引的值或大于该处的索引的值朝列表的末尾下移(并且其索引加一)。如果属性值是无序的并且已经<yǐ jing>具有 attrval,则抛出 illegalstateexception

参数:
ix - 要添加新值的属性值的有序列表中的索引。0 <=ix <=size()
attrval - 要添加的可能为 null 的属性值;如果为 null,则 null 即为添加的值。
抛出:
indexoutofboundsexception - 如果 ix 位于指定范围之外。
illegalstateexception - 如果属性值是无序的并且 attrval 是这些值之一。

set

object set(int ix,  object attrval)
设置属性值的有序列表中的属性值。此方法将属性值列表中 ix 索引处的值设置为 attrval。移除旧值。如果属性值是无序的,则此方法将正好位于该索引处的值设置为 attrval,除非 attrval 已经<yǐ jing>是这些值中的一个。若其已经是这些值中的一个,则抛出 illegalstateexception

参数:
ix - 属性值的有序列表中值的索引。0 <=ix < size()
attrval - 要使用的可能为 null 的属性值。如果为 null,则 'null' 将替换旧值。
返回:
已替换的索引 ix 处的可能为 null 的属性值。如果属性值已为 null,则返回 null。
抛出:
indexoutofboundsexception - 如果 ix 位于指定范围之外。
illegalstateexception - 如果 attrval 已存在并且属性值是无序的。

javatm platform
standard ed. 6

提交错误或意见<remark>
有关更多的 api 参考资料和开发<kāi fā>人员文档,请参阅 java se 开发<kāi fā>人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作<work>代码示例。

版权所有 2007 sun microsystems, inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策