org.apache.shiro.jndi

Interface JndiCallback

public interface JndiCallback

Callback interface to be implemented by classes that need to perform an operation (such as a lookup) in a JNDI context. This callback approach is valuable in simplifying error handling, which is performed by the JndiTemplate class. This is a similar to JdbcTemplate's approach.

Note that there is hardly any need to implement this callback interface, as JndiTemplate provides all usual JNDI operations via convenience methods.

Note that this interface is an exact copy of the Spring Framework's identically named interface from their 2.5.4 distribution - we didn't want to re-invent the wheel, but not require a full dependency on the Spring framework, nor does Spring make available only its JNDI classes in a small jar, or we would have used that. Since Shiro is also Apache 2.0 licensed, all regular licenses and conditions and authors have remained in tact.

See Also:

JndiTemplate

Method Summary

Modifier and Type	Method and Description
Object	doInContext(Context ctx) Do something with the given JNDI context.

Method Detail

doInContext

Object doInContext(Context ctx)
            throws NamingException

Do something with the given JNDI context. Implementations don't need to worry about error handling or cleanup, as the JndiTemplate class will handle this.

Parameters:

ctx - the current JNDI context

Returns:

a result object, or null

Throws:

NamingException - if thrown by JNDI methods