org.apache.jk.common
Class ChannelJni

java.lang.Object
  org.apache.jk.core.JkHandler
      org.apache.jk.common.JniHandler
          org.apache.jk.common.ChannelJni

All Implemented Interfaces:

java.util.EventListener, javax.management.MBeanRegistration, javax.management.NotificationListener, JkChannel

public class ChannelJni
extends JniHandler
implements JkChannel

Pass messages using jni

Author:

Costin Manolache

ChannelJni

public ChannelJni()

init

public void init()
          throws java.io.IOException

Description copied from class: JniHandler

You must call initNative() inside the component init()

Overrides:

init in class JniHandler

Throws:

java.io.IOException

receive

public int receive(Msg msg,
                   MsgContext ep)
            throws java.io.IOException

Receives does nothing - send will put the response in the same buffer

Specified by:

receive in interface JkChannel

Parameters:

msg - The place to recieve the data into.

ep - The connection point for this request.

Throws:

java.io.IOException

send

public int send(Msg msg,
                MsgContext ep)
         throws java.io.IOException

Send the packet. XXX This will modify msg !!! We could use 2 packets, or sendAndReceive().

Specified by:

send in interface JkChannel

Parameters:

msg - The message to send.

ep - The connection point for this request.

Throws:

java.io.IOException

flush

public int flush(Msg msg,
                 MsgContext ep)
          throws java.io.IOException

Description copied from interface: JkChannel

Flush the data to the client.

Specified by:

flush in interface JkChannel

Throws:

java.io.IOException

isSameAddress

public boolean isSameAddress(MsgContext ep)

Description copied from interface: JkChannel

Confirm that a shutdown request was recieved form us.

Specified by:

isSameAddress in interface JkChannel

registerRequest

public void registerRequest(Request req,
                            MsgContext ep,
                            int count)

Description copied from interface: JkChannel

Register a new Request in the Request pool.

Specified by:

registerRequest in interface JkChannel

getChannelName

public java.lang.String getChannelName()

Description copied from interface: JkChannel

Return the identifying name of this Channel.

Specified by:

getChannelName in interface JkChannel

invoke

public int invoke(Msg msg,
                  MsgContext ep)
           throws java.io.IOException

Receive a packet from the C side. This is called from the C code using invocation, but only for the first packet - to avoid recursivity and thread problems. This may look strange, but seems the best solution for the problem ( the problem is that we don't have 'continuation' ). sendPacket will move the thread execution on the C side, and return when another packet is available. For packets that are one way it'll return after it is processed too ( having 2 threads is far more expensive ). Again, the goal is to be efficient and behave like all other Channels ( so the rest of the code can be shared ). Playing with java objects on C is extremely difficult to optimize and do right ( IMHO ), so we'll try to keep it simple - byte[] passing, the conversion done in java ( after we know the encoding and if anyone asks for it - same lazy behavior as in 3.3 ).

Specified by:

invoke in interface JkChannel

Overrides:

invoke in class JniHandler

Throws:

java.io.IOException