org.apache.jk.common

Class JniHandler

public class JniHandler extends JkHandler

Base class for components using native code ( libjkjni.so ). It allows to access the jk_env and wrap ( 'box' ? ) a native jk component, and call it's methods. Note that get/setAttribute are expensive ( Strings, etc ), invoke() is were all optimizations are done. We do recycle all memory on both C and java sides ( the only exception is when we attempt pinning but the VM doesn't support it ). The low level optimizations from ByteBuffer, etc are used to reduce the overhead of passing strings.

Author: Costin Manolache

Field Summary
protected AprImpl	apr
protected String	jkHome
static int	JK_HANDLE_JNI_DISPATCH
static int	JK_HANDLE_SHM_DISPATCH
static int	MB_NOTE
static int	MSG_NOTE
protected long	nativeJkHandlerP

Constructor Summary
	JniHandler()

Method Summary
void	appendString(Msg msg, String s, C2BConverter charsetDecoder)
MsgContext	createMsgContext() Create a msg context to be used with the shm channel
void	destroyJkComponent()
String	getJkHome()
void	init() You must call initNative() inside the component init()
void	initJkComponent()
protected void	initNative(String nativeComponentName)
int	invoke(Msg msg, MsgContext ep) Base implementation for invoke.
protected int	nativeDispatch(Msg msg, MsgContext ep, int code, int raw) send and get the response in the same buffer.
void	pause()
protected void	recycleNative(MsgContext ep)
void	resume()
void	setJkHome(String s)
void	setNativeAttribute(String name, String val)
protected void	setNativeEndpoint(MsgContext msgCtx)