ebaysdkcore
, also known as the "eBay SDK for Java" provides convenient access to the eBay Trading API. It contains code generated from the Trading API WSDL and a thin wrapper which simplify common tasks like providing credentials or setting commonly used parameters.
This project aims to provide a reliable build of the official eBay source code releases for the eBay SDK for Java, conventiently distributed via the Maven Central Repository, with minimal differences to the binaries found in the official eBay downloads.
Find the latest version of the project in the Maven Central Repository.
- eBay SDK for Java - eBay web site for the Java SDK. Here you will find all the documentation and getting starting guides relevant to this project. Official eBay releases can also be downloaded from here.
- Getting Started Guide - instructions for how to get up and running with this project.
- Trading API reference - API reference for the Trading API, which is the API covered by this SDK (software development kit). The API can also be used without this SDK of course as it is simply a SOAP web service.
- Trading API release notes - find details about what features of the API will be supported by different versions of this SDK.
- eBay developers program home - Main site for all resources related to the eBay APIs. Here you can sign up to the eBay Developers Program and gain access to the eBay API.
- eBay Shopping API - JAX-WS classes for the eBay Shopping API.
Major versions are maintained in a one to one correspondance with the versions of releases made available on the eBay Developer Program website. For example, version 981.0.0
of this project would be a build of Version 981 of the eBay release. Subsequent minor or patch versions of this projects (981.0.1
, 981.1.0
etc) represent builds from the same eBay source code. eBay maintains a one to one correspondence between versions of the SDK and versions of the Trading API.
A small number of changes are maintained in order to make the artifacts more suitable for distribution via Maven:
- Declared compile dependencies on
log4j:log4fj
andcommons-logging:commons-logging
have been removed to allow users of this project to select their own logging implementation, as the eBay source code usesorg.slf4j:slf4j-api
exculsively. - JAX-WS Code generation from the WSDL is done with a Maven plugin (
jaxws-maven-plugin
) instead of running the Ant taskcom.sun.tools.ws.ant.WsImport
via the Maven pluginmaven-antrun-plugin
. This is to prevent hard coded file system paths forwsdlLocation
ending up in the generated source code (see Stack Overflow) - The provided WSDL
eBaySvc.wsdl
is packaged inside eBay's namespacecom.ebay.sdk
instead of at the root of the classpath. If you need to load the WSDL from the classpath, you can use"com/ebay/sdk/eBaySvc.wsdl"
instead of"eBaySvc.wsdl"
as the path.