You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by co...@apache.org on 2001/11/02 05:22:59 UTC
cvs commit: jakarta-tomcat-connectors/jk/native/common jk_channel.h
costin 01/11/01 20:22:59
Added: jk/native/common jk_channel.h
Log:
A first step in abstracting the TCP communication and adding support for
faster mechanisms.
Revision Changes Path
1.1 jakarta-tomcat-connectors/jk/native/common/jk_channel.h
Index: jk_channel.h
===================================================================
/* ========================================================================= *
* *
* The Apache Software License, Version 1.1 *
* *
* Copyright (c) 1999-2001 The Apache Software Foundation. *
* All rights reserved. *
* *
* ========================================================================= *
* *
* Redistribution and use in source and binary forms, with or without modi- *
* fication, are permitted provided that the following conditions are met: *
* *
* 1. Redistributions of source code must retain the above copyright notice *
* notice, this list of conditions and the following disclaimer. *
* *
* 2. Redistributions in binary form must reproduce the above copyright *
* notice, this list of conditions and the following disclaimer in the *
* documentation and/or other materials provided with the distribution. *
* *
* 3. The end-user documentation included with the redistribution, if any, *
* must include the following acknowlegement: *
* *
* "This product includes software developed by the Apache Software *
* Foundation <http://www.apache.org/>." *
* *
* Alternately, this acknowlegement may appear in the software itself, if *
* and wherever such third-party acknowlegements normally appear. *
* *
* 4. The names "The Jakarta Project", "Jk", and "Apache Software *
* Foundation" must not be used to endorse or promote products derived *
* from this software without prior written permission. For written *
* permission, please contact <ap...@apache.org>. *
* *
* 5. Products derived from this software may not be called "Apache" nor may *
* "Apache" appear in their names without prior written permission of the *
* Apache Software Foundation. *
* *
* THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES *
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY *
* AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL *
* THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY *
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL *
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS *
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) *
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, *
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN *
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE *
* POSSIBILITY OF SUCH DAMAGE. *
* *
* ========================================================================= *
* *
* This software consists of voluntary contributions made by many indivi- *
* duals on behalf of the Apache Software Foundation. For more information *
* on the Apache Software Foundation, please see <http://www.apache.org/>. *
* *
* ========================================================================= */
#include "jk_global.h"
#include "jk_logger.h"
#include "jk_pool.h"
/**
* Abstraction (interface) for sending/receiving blocks of data ( packets ).
* This will be used to replace the current TCP/socket code and allow other
* transports. JNI, shmem, doors and other mechanisms can be tryed out, and
* we can also have a gradual transition to APR. The current tcp-based transport
* will be refactored to this interface.
*
* XXX Experimental
*
* Issues:
* - Should the transport also check the packet integrity ( envelope ) ?
* - This is supposed to work for send/receive sequences, and the buffer
* shouldn't be modified until a send/receive is completed ( we want to
* avoid memcpy )
* - We need to extend/generalize the mechanisms in 'worker' to support other
* types of internal interfaces.
* - this interface is using get/setProperty model, like in Java beans ( well,
* just a generic get/set method, no individual setters ). This is different
* from worker, which gets a map at startup. This model should also allow
* run-time queries for status, management, etc - but it may be too complex.
*
* @author Costin Manolache
*/
struct jk_channel {
void *private;
/** Pool for the channel
*/
jk_pool_t *pool;
jk_logger_t *logger;
char *name;
/** Open the communication channel
*/
int (JK_METHOD *open)(jk_channel_t *_this );
/** Close the communication channel
*/
int (JK_METHOD *close)(jk_channel_t *_this );
/** Send a packet
*/
int (JK_METHOD *send)(jk_channel_t *_this,
const unsigned char *b,
int len);
/** Receive a packet
*/
int (JK_METHOD *recv)(jk_channel_t *_this,
const unsigned char *b,
int len);
/** Set a channel property. Properties are used to configure the
* communication channel ( example: port, host, file, shmem_name, etc).
*/
int (JK_METHOD *setProperty)(jk_channel_t *_this,
char *name, char *value);
/** Get a channel property
*/
int (JK_METHOD *getProperty)(jk_channel_t *_this,
char *name, char **value);
}
typedef struct jk_channel jk_channel_t;
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>