Преглед на JNDI, Част 3: Разширени JNDI

Този месец трябва да покрия много земя, така че ще оставя пухчето и ще отсека точно до точките. Първо, Java Naming и Directory Interface играе важна роля в няколко Java технологии. Ще разгледаме тази роля, за да разберем по-добре стратегическата позиция на JNDI в цялостната картина на Java. След това, като признание за нуждата ви от работеща JNDI услуга, с която да играете, ще ви запозная с свободно достъпна, преносима LDAP реализация и ще ви науча как да се свързвате и да използвате доставчик на JNDI услуги. Накрая ще ви разгледам отблизо обвързващите обекти към записи в JNDI.

ТЕКСТОВО ПОЛЕ:

TEXTBOX_HEAD: Общ преглед на JNDI: Прочетете цялата поредица!

  • Част 1. Въведение в услугите за именуване

  • Част 2. Използвайте JNDI директорийни услуги, за да управлявате по-добре вашите разпределени приложения

  • Част 3. Използвайте JNDI, за да съхранявате обектите на вашето разпределено приложение

  • Част 4. Съберете наученото с приложение с активиран JNDI

: END_TEXTBOX

Преди да започна, малко двойно мислене е в ред. През последните два месеца се опитах да ви убедя, че услугите за именуване и директории са приблизително електронният еквивалент на картовите каталози, намерени в библиотеките. Сега, когато започваме обиколката си за усъвършенстваните функции на JNDI, искам да забравите напълно тази аналогия - тя грубо подценява силата на JNDI.

Нека започнем с поглед към това как JNDI се появява в други Java технологии.

JNDI навсякъде

JNDI играе роля в редица Java технологии. Нека разгледаме три от тях: JDBC (пакетът за свързване на база данни на Java), JMS (услугата за съобщения на Java) и EJB (Enterprise JavaBeans).

JDBC е Java технологията за релационни бази данни. JNDI се появи за първи път в незадължителния пакет JDBC 2.0 (вж. Ресурси) заедно с DataSourceинтерфейса. А DataSourceнапример, както подсказва името му, представлява източник на данни - често от база данни, но не винаги. А DataSourceинстанция съхранява информация за източник на данни - като името, водачът на натоварване и употреба, както и местоположението му - и позволява на приложенията да се получи връзка към източника на данни, без оглед на детайлите, подкрепящи. Спецификацията JDBC препоръчва използването на JNDI за съхраняване на DataSourceобекти.

JMS е Java технологията за съобщения. Спецификацията JMS описва администрирани обекти - обекти, които съдържат информация за конфигурация на JMS и се използват от JMS клиенти за намиране на конкретни опашки и теми за съобщения. Както е случаят с JDBC, спецификацията препоръчва намирането на обекти, управлявани от JMS, чрез JNDI.

И накрая, помислете за Enterprise JavaBeans. Всички корпоративни компоненти публикуват домашен интерфейс - единственото местоположение, чрез което клиентите намират конкретен корпоративен боб - чрез JNDI.

Какво внася JNDI на масата, което го кара да бъде толкова високо ценен?

Първо, JNDI популяризира идеята за централно управляван източник на информация - ключово изискване за корпоративни приложения. Централизирано управляваният източник на информация е по-лесен за администриране, отколкото разпределена колекция от източници на информация. Също така е по-лесно за клиентите да намерят необходимата информация, ако трябва да търсят само на едно място.

Второ, както ще видите, способността на JNDI да съхранява директно Java обекти му позволява да се интегрира почти прозрачно в Java приложения.

Точката на доставчика

За да използвате JNDI, имате нужда от услуга за именуване и указатели и доставчик на услуги за JNDI. Sun доставя няколко доставчици на общи услуги за имена и директории (COS имена, NIS, регистър RMI, LDAP и др.). Аз се спрях на LDAP.

LDAP (Лек протокол за достъп до директории) има двойните предимства, че е широко внедрен (както в търговска, така и в безплатна форма) и е сравнително лесен за използване. Неговите функции също се поддържат добре от доставчика на услуги на LDAP на Sun и JNDI.

Тъй като получаването и конфигурирането на LDAP сървър всъщност не е предмет на Java, ще ви насоча само в правилната посока и ще ви предоставя препратки към интернет ресурси.

Предлагат се множество внедрения на LDAP. Много от тях са търговски продукти като Netscape Directory Server и IBM Secure Way Directory. Някои са пакетирани като част от по-големи предложения (Active Directory на Microsoft е част от Windows 2000). Ако имате достъп до такава реализация, можете да пропуснете по-голямата част от този раздел. В противен случай ще опиша OpenLDAP - свободно достъпна реализация на LDAP, базирана на референтната реализация на Университета в Мичиган - както и неговата инсталация и конфигурация.

OpenLDAP се предлага от фондацията OpenLDAP (вж. Ресурси). Лицензът му се основава на „художествения лиценз“ на Perl, което означава, че OpenLDAP е безплатен (или с отворен код) софтуер. Предварително пакетирани двоични файлове се предлагат за различни вкусове на Linux (Debian, Red Hat), както и BSD Unix. Работи се по порт за Windows NT.

Ако планирате да инсталирате OpenLDAP, трябва да прочетете Ръководството за администратор на SLAPD и SLURPD (slapd е името на изпълнимия LDAP сървър и slurpd е името на LDAP сървъра за репликация; вижте Ресурси за местоположението)

I have one final suggestion to make your entire experience more pleasing: no matter which LDAP implementation you use, turn schema checking off. An LDAP schema, like a database schema, defines constraints on the stored information. In normal use, schema checking helps ensure that entries (think of address book entries) conform to the correct format. However, since you'll probably be playing rather than building something of lasting significance, schema checking will just get in the way. Take my word for it.

Connecting to a JNDI context

In previous articles, I tried to avoid explaining in detail how to interact with a JNDI service provider such as the LDAP service provider. I mentioned that you need an initial context to do JNDI operations, but I didn't spend much time telling you how to get one. Let me fill in the gaps. (For more on initial contexts, see the first two articles in this series.)

Before you can do anything with JNDI, you need an initial context. All operations are performed relative to the context or one of its subcontexts.

Obtaining an initial context requires three steps:

  1. First, select a service provider. If you're going to use OpenLDAP or some other LDAP implementation, Sun supplies a reference LDAP service provider (see Resources). Add the name of the service provider to the set of environment properties (stored in a Hashtable instance):

     Hashtable hashtableEnvironment = new Hashtable(); hashtableEnvironment.put( Context.INITIAL_CONTEXT_FACTORY, "com.sun.jndi.ldap.LdapCtxFactory" ); 
  2. Add any extra information the service provider requires. For LDAP, that includes the URL that identifies the service, the root context, and the name and password to connect with:

     // the service: ldap://localhost:389/ // the root context: dc=etcee,dc=com hashtableEnvironment.put( Context.PROVIDER_URL, "ldap://localhost:389/dc=etcee,dc=com" ); hashtableEnvironment.put( Context.SECURITY_PRINCIPAL, "name" ); hashtableEnvironment.put( Context.SECURITY_CREDENTIALS, "password" ); 
  3. Finally, get the initial context. If you just intend to perform naming operations, you'll only need a Context instance. If you intend to perform a directory operation as well, you'll need a DirContext instance instead. Not all providers supply both:

     Context context = new InitialContext(hashtableEnvironment); 

    Or:

     DirContext dircontext = new InitialDirContext(hashtableEnvironment); 

That's all there is to it. Now let's look at how applications store objects to and retrieve objects from JNDI.

Work with objects

The ability to store Java objects is useful: object storage provides persistence and allows objects to be shared between applications or between different executions of the same application.

From the standpoint of the code involved, object storage is surprisingly easy:

 context.bind("name", object) 

The bind() operation binds a name to a Java object. The syntax of the command is reminiscent of RMI, but the semantics are not as clearly defined. It's permissible for the bind() operation to store either a snapshot of the object or a reference to a "live" object, for example.

Be aware that the bind() operation throws a NamingException if an exception occurs during the execution of the operation.

Now let's take a look at the bind() operation's complement -- lookup():

 Object object = context.lookup("name") 

The lookup() operation retrieves the object bound to the specified name. Once again, the syntax is reminiscent of RMI, but the method's semantics are not as clearly defined.

Just as with bind(), the lookup() operation throws a NamingException if an exception occurs during the execution of the operation.

Object storage

What does it mean to store an object in a JNDI naming and directory service? We've already mentioned that the exact semantics of the bind() and lookup() operations aren't tightly defined; it's up to the JNDI service provider to define their semantics.

According to the JNDI specification, service providers are encouraged (but not required) to support object storage in one of the following formats:

  • Serialized data
  • Reference
  • Attributes in a directory context

If all JNDI service providers support these standard mechanisms, Java programmers are free to develop generic solutions that work even when the underlying service provider layer changes.

Each of the methods above has advantages and disadvantages. The best method will depend on the requirements of the application under development.

Let's consider each in turn.

As serialized data

The most obvious approach to storing an object in a directory is to store the serialized representation of an object. The only requirement is that the object's class implement the Serializable interface.

When an object is serialized, its state becomes transformed into a stream of bytes. The service provider takes the stream of bytes and stores it in the directory. When a client looks up the object, the service provider reconstructs it from the stored data.

The following code demonstrates how to bind a LinkedList to an entry in an JNDI service:

 // create linked list LinkedList linkedlist = new LinkedList(); . . . // bind context.bind("cn=foo", linkedlist); . . . // lookup linkedlist = (LinkedList)context.lookup("cn=foo"); 

It's that easy!

Unfortunately, the other two methods are more complicated. I will describe them briefly but reserve a detailed discussion for a later date.

As a reference

Sometimes it's not appropriate (or possible) to serialize an object. If the object provides a service on a network, for example, it doesn't make sense to store the state of the object itself. We're interested in the information necessary to find and communicate with the object.

An example is a connection to an external resource (one outside the scope of the Java Virtual Machine) such as a database or file. It clearly doesn't make sense to try to store the database or the file itself in the JNDI service. Instead, we want to store the information necessary to reconstruct the connection.

In this case the programmer should either bind a Reference instance that corresponds to the object or have the object's class implement the Referenceable interface (in which the object generates and provides a Reference instance when requested by the service provider).

The Reference instance contains enough information to recreate the reference. If a reference to a file was stored, the reference contains enough information to create a File object that points to the correct file.

As attributes

If you're using a service provider that provides directory functionality instead of only naming functionality, you can also store an object as a collection of attributes on a DirContext object (a DirContext instance differs from a Context instance in that it may have attributes).

To use this method, you must create objects that implement the DirContext interface and contain the code necessary to write their internal state as an Attributes object. You must also create an object factory to reconstitute the object.

This approach is useful when the object must be accessible by non-Java applications.

Conclusion

If you've read the series, you should understand and appreciate the power and importance of JNDI -- you don't hear much about it, but it's there under the covers.

Следващият месец ще разгледаме приложение, базирано на JNDI. Междувременно трябва да опитате да стартирате JNDI и да работи на LDAP сървър.

Научете повече за тази тема

  • Опционалният пакет JDBC 2.0

    //java.sun.com/products/jdbc/articles/package2.html

  • Отидете в OpenLDAP Foundation, за да изтеглите OpenLDAP

    //www.openldap.org/

  • За да изтеглите Ръководството за администратор на SLAPD и SLURPD , отидете на

    //www.umich.edu/~dirsvcs/ldap/doc/guides/

  • Информация за JNDI, доставчици на услуги и т.н.

    //java.sun.com/products/jndi/

Тази история, „Преглед на JNDI, Част 3: Разширени JNDI“, първоначално е публикувана от JavaWorld.