ajp-client

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #cli #dsh #claude-code #codex #developer-tools #react

★ 31 Open GitHub ↗

Java implementation of an AJP13 protocol client (aka Apache JServ), allowing to send requests to a servlet container using this protocol.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

java client library for the Apache JServ Protocol 1.3
==============================

Java implementation of an [AJP13](https://en.wikipedia.org/wiki/Apache_JServ_Protocol) protocol client, allowing to send requests to a servlet container using this protocol.

It uses [netty](https://netty.io/), and handles [connection pooling](https://github.com/hexiaofeng/poolnetty).

Licensed under the Apache License, Version 2.0 (see [LICENSE](https://github.com/jrialland/ajp-client/blob/master/LICENSE))

[![Build Status](https://api.travis-ci.com/jrialland/ajp-client.svg)](https://app.travis-ci.com/github/jrialland/ajp-client)
[![](https://jitpack.io/v/jrialland/ajp-client.svg)](https://jitpack.io/#jrialland/ajp-client)
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.jrialland/ajpclient/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.github.jrialland/ajpclient)
[![Coverage Status](https://img.shields.io/coveralls/jrialland/ajp-client.svg)](https://coveralls.io/r/jrialland/ajp-client)
[![Known Vulnerabilities](https://snyk.io/test/github/jrialland/ajp-client/badge.svg)](https://snyk.io/test/github/jrialland/ajp-client)

![Commits](https://www.openhub.net/p/ajp-client/analyses/latest/commits_spark.png)
[![Code statistics](http://www.ohloh.net/p/ajp-client/widgets/project_thin_badge.gif)](https://www.ohloh.net/p/ajp-client)

Simple Usecases :
------------------

* Making a cPing request (checks server availability)

```java
	import com.github.jrialland.ajpclient.pool.Channels;
	import com.github.jrialland.ajpclient.CPing;

...

//get a tcp connection
	final Channel channel = Channels.connect("localhost", 8009);
	//will try a cping/cpong exchange on the opened tcp connection
	boolean success = new CPing(2, TimeUnit.SECONDS).execute(channel);
  //                                                .execute("localhost", 8009);	
```

* Making a forward request (serves web content)

```java
	import com.github.jrialland.ajpclient.pool.Channels;
	import com.github.jrialland.ajpclient.Forward;

//send a forward request
	new Forward(ajpRequest, ajpResponse).execute("localhost", 8009);
	
```

* Using a client sockets pool :

Socket pools handle the creation and destruction of multiple connections automatically.

```java
	import com.github.jrialland.ajpclient.pool.Channels;
	import com.github.jrialland.ajpclient.Forward;
	
	Channels.getPool("localhost", 8009).execute(new Forward(ajpRequest, ajpResponse));
	
```
Will use a socket channel picked from a pool, allowing the reuse of sockets among request.

* The library can be used directly in a servlet container in order to forward requests to another servlet container :

```java
	import javax.servlet.http.HttpServletRequest;
	import javax.servlet.http.HttpServletResponse;
	import com.github.jrialland.ajpclient.servlet.AjpServletProxy;
	
	HttpServletRequest request = ...
	HttpServetResponse response = ...
	
	//forward an servlet request to another server
	AjpServletProxy.forHost("localhost", 8009).forward(request, response);
```

Note on AJP header size limit
---------------------

The protocol does not allow request headers to be greater that 8K, which is ok most of the time.
  You should avoid to pass more that 8k of headers, but if you do, to overcome this limit, at least with tomcat 5.5.21+ and Tomcat 6.0.1+

1) add the ``packetSize`` attribute to the connector's declaration

```xml
    <Connector port="8009" protocol="AJP/1.3"
               packetSize="20000"
               redirectPort="8443" ></Connector>
```

2) Change the limit in Apache Server configuration :
```
ProxyIOBufferSize 19000 
LimitRequestFieldsize 18000
```

ajp-client

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README