JNDI 是什么

Java Naming and Directory Interface

JNDI(Java Naming and Directory Interface,Java命名和目录接口)是一组在Java应用中访问命名和目录服务的API。命名服务将名称和对象联系起来,使得我们可以用名称访问对象。目录服务是一种命名服务,在这种服务里,对象不但有名称,还有属性。

JNDI可访问的现有的目录及服务有:
DNS、XNam 、Novell 目录服务、LDAP(Lightweight Directory Access Protocol 轻型目录访问协议)、 CORBA 对象服务、文件系统、Windows XP/2000/NT/Me/9x的 注册表、RMI、DSML v1&v2、NIS。
 
1 )五个包:

javax.naming

javax.naming.directory

javax.naming.event

javax.naming.ldap

javax.naming.spi

其中前面4package定义了JNDI客户端接口,面向使用命名和目录服务的应用。最后的javax.naming.spi定义了JNDI服务提供者接口(SPI),面向不同的命名和目录服务提供者。

2)命名服务:javax.Naming

——Context接口和InitialContext

Context是命名服务的核心接口,提供对象查找,绑定/解除绑定,重命名对象,创建和销毁子上下文等操作。InitialContext类实现了Context接口,是访问命名服务的起始上下文,通过它可查找对象和子上下文。

Context主要方法:

根据名称获取对象:

Object lookup(Name name) 

Object lookup(String name)

绑定名称到对象:void bind(Name name, Object obj)  

void bind(String name, Object obj)

解除绑定,释放对象:

void unbind(Name name) 

void unbind(String name) 

将对象和一个已经存在的名称重新绑定:

void rebind(Name name, Object obj)

void rebind(String name, Object obj)

修改对象名称:

void rename(Name oldName, Name newName) 

void rename(String oldName, String newName) 

列出上下文中的所有对象名称信息。NameClassPair包含对象名称和对象类名:

NamingEnumeration<NameClassPair> list(Name name)

NamingEnumeration<NameClassPair> list(String name) 

列出上下文中的所有绑定:

NamingEnumeration<Binding> listBindings(Name name)

NamingEnumeration<Binding> listBindings(String name) 

创建子上下文:

Context createSubcontext(Name name)

Context createSubcontext(String name)

销毁子上下文:

void destroySubcontext(Name name)

void destroySubcontext(String name) 

——Name接口

对应于命名服务概念中的对象名称。它的具体实现可能是一个简单的字符串,也可能是一个复杂对象。CompoundName类和CompositeName类均实现了Name接口,分别代表复合名称和混合名称。

——Binding

对应于命名服务概念中的绑定。一个Binding包含对象名称,对象的类名称,对象本身。

——Referenceable接口和Reference

命名服务中对象的存储方式各不相同。有的将对象直接序列化,这时实现标准的Serializable接口接口。有的要将对象存储在命名系统外部,这就要用到Referenceable接口和Reference类了。Reference类包含了怎样构造出一个实际对象的信息,实际对象则需要实现Referenceable接口。

Referenceable主要方法:

返回对象的引用:Reference getReference()

当将一个实现了Referenceable接口的对象绑定到Context时,实际上通过getReference()得到它的Reference进行绑定。而如何从Reference中创建出Referenceable实例,则由具体的SPI实现,JNDI客户不用关心。

3)目录服务:javax.naming.directory

——DirContext接口和InitialDirContext

DirContext是目录服务的核心接口,它扩展了Context接口,除了提供了命名服务的各种操作外,还提供了访问和更新目录对象属性的操作,以及Search操作。InitialDirContext类扩展InitialContext类并实现了DirContext接口,是访问目录服务的起始点。

DirContext主要方法:

binding/rebing/unbinding等方法与Context类似,区别是各个方法中均添加了Attributes参数,表示绑定的是一个目录对象,其中有对象本身,还有对象的属性集合。这里不再列举。

获取对象的属性集合:

Attributes getAttributes(Name name)

修改对象的属性集合:

void modifyAttributes(Name name, int mod_op, Attributes attrs)

搜索包含匹配的属性的对象:

NamingEnumeration<SearchResult> search(Name name, Attributes matchingAttributes)

通过查询过滤条件进行搜索,同时指定了搜索控制:

NamingEnumeration<SearchResult> search(Name name, String filter, SearchControls cons) 

——Attribute接口和Attributes接口

Attribute接口对应于目录服务概念中的属性。Attributes表示属性的集合。

——SearchResult类和SearchControls

SearchResult类继承自Binding类,表示DirContextsearch操作的结果。SearchControls类用于对搜索操作进行更精细的控制,如指定搜索范围(Scope),时间限制(TimeLimit)和结果数量限制(CountLimit)

4)命名和目录服务事件:javax.naming.event

——EventContext接口和EventDirContext接口

分别表示支持事件通知的上下文,提供了添加和删除事件监听器的操作。

——NamingEvent

命名和目录服务产生的事件。包含一个type表示不同的事件类型。

——NamingListener/NamespaceChangeListener/ObjectChangeListener

NamingListener是处理NamingEvent事件监听器的接口,NamespaceChangeListenerObjectChangeListener是它的两个子接口,分别定义了各自感兴趣的NamingEvent事件类型的处理方法。

 

你可能感兴趣的:(JNDI 是什么)