Dropship Agent Library

Library to aid in the development of Dropship friendly agents

License	Apache 2.0
GroupId	com.zulily.dropship
ArtifactId	dropship-agent
Last Version	0.1
Release Date	May 5, 2014
Type	jar
Description	Dropship Agent Library Library to aid in the development of Dropship friendly agents
Project URL	https://github.com/zulily/dropship-agent
Project Organization	zulily, Inc.
Source Code Management	http://github.com/zulily/dropship-agent

Download dropship-agent

Filename	Size
dropship-agent-0.1.pom
dropship-agent-0.1.jar	7 KB
dropship-agent-0.1-sources.jar	4 KB
dropship-agent-0.1-javadoc.jar	41 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.zulily.dropship/dropship-agent/ -->
<dependency>
    <groupId>com.zulily.dropship</groupId>
    <artifactId>dropship-agent</artifactId>
    <version>0.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.zulily.dropship/dropship-agent/
implementation 'com.zulily.dropship:dropship-agent:0.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.zulily.dropship/dropship-agent/
implementation ("com.zulily.dropship:dropship-agent:0.1")

Apache Buildr

'com.zulily.dropship:dropship-agent:jar:0.1'

Apache Ivy

<dependency org="com.zulily.dropship" name="dropship-agent" rev="0.1">
  <artifact name="dropship-agent" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.zulily.dropship', module='dropship-agent', version='0.1')
)

Scala SBT

libraryDependencies += "com.zulily.dropship" % "dropship-agent" % "0.1"

Leiningen

[com.zulily.dropship/dropship-agent "0.1"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.javassist : javassist	jar	3.18.1-GA

test (2)

Group / Artifact	Type	Version
junit : junit	jar	4.11
org.easytesting : fest-assert	jar	1.4

Project Modules

There are no modules declared in this project.

dropship-agent

Library for aiding in the development of "agents" or "plugins" for dropship.

What For?

Implement a dropship agent if you wish to have code that runs before and after your target application. For example, you may wish to start up some threads that send JMX metrics to statsd.

How?

BaseAgent provides methods to configure basic interaction with the Dropship lifecycle. Instances of subclasses of BaseAgent are wired in to the preRun, onError and onExit methods of Dropship.

To build a Dropship agent,

1. Extend BaseAgent
   • Implement onStart(Properties, String, Class, Method, Object[]) - which will be invoked just before Dropship hands control over to the target
   • Implement onError(Throwable) - which will be invoked in the event of an exception from the target (or an unhandled exception in any threads).
   • Implement onExit(), which will be invoked as Dropship is shutting down
2. Create a public static void premain(String agentArgument, Instrumentation instrumentation) method
   • In it, instantiate your agent
   • Pass that instance to premain(String, Instrumentation, BaseAgent)
3. Package your agent as a jar file. You will probably want to create a "shaded" jar
4. Add a Premain-Class entry to the MANIFEST.MF in your jar file
5. Use your agent from the command line: java -javaagent:youragent.jar -jar dropship.jar ...

License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

zulily

Versions

Version
0.1 May 5, 2014