Skip to content

opendxl/opendxl-streaming-client-java

Repository files navigation

OpenDXL Streaming Java Client Library

License Build Status

Overview

The OpenDXL Streaming Java client library is used to consume records from as well as to produce records to a Data Exchange Layer (DXL) Streaming Service.

The DXL Streaming Service exposes a REST-based API that communicates with a back-end streaming platform (Kafka, Kinesis, etc.). The streaming service performs authentication and authorization and exposes methods to retrieve records and to send them.

One concrete example of a DXL Streaming Service is the McAfee MVISION EDR "Events feed".

Documentation

See the Wiki for an overview of the OpenDXL Streaming Java client library and examples.

See the OpenDXL Streaming Java Client Library Documentation for API documentation and examples.

Installation

To start using the OpenDXL Streaming Java Client Library:

  • Download the Latest Release
  • Extract the release .zip file
  • View the README.html file located at the root of the extracted files.
    • The README links to the documentation which includes installation instructions, API details, and samples.
    • The SDK documentation is also available on-line here.

Maven Repository

Visit the OpenDXL Streaming Java Client Maven Repository for access to all released versions including the appropriate dependency syntax for a large number of management systems (Maven, Gradle, SBT, Ivy, Grape, etc.).

Maven:

<dependency>
  <groupId>com.opendxl</groupId>
  <artifactId>dxlstreamingclient</artifactId>
  <version>0.1.8</version>
</dependency>

or Gradle:

compile 'com.opendxl:dxlstreamingclient:0.1.8'

Bugs and Feedback

For bugs, questions and discussions please use the GitHub Issues.

LICENSE

Copyright 2018, McAfee LLC

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.