Dapr SDK for Java
Go to file
dependabot[bot] d66a438bda Bump jackson-databind from 2.9.9 to 2.9.10.1 in /sdk (#155)
Bumps [jackson-databind](https://github.com/FasterXML/jackson) from 2.9.9 to 2.9.10.1.
- [Release notes](https://github.com/FasterXML/jackson/releases)
- [Commits](https://github.com/FasterXML/jackson/commits)

Signed-off-by: dependabot[bot] <support@github.com>
2020-01-24 14:14:08 -08:00
.github Java SDK with all features implemented for milestone 0.4 (#154) 2020-01-24 12:49:56 -08:00
examples Java SDK with all features implemented for milestone 0.4 (#154) 2020-01-24 12:49:56 -08:00
proto Java SDK with all features implemented for milestone 0.4 (#154) 2020-01-24 12:49:56 -08:00
sdk Bump jackson-databind from 2.9.9 to 2.9.10.1 in /sdk (#155) 2020-01-24 14:14:08 -08:00
sdk-actors Java SDK with all features implemented for milestone 0.4 (#154) 2020-01-24 12:49:56 -08:00
sdk-autogen Java SDK with all features implemented for milestone 0.4 (#154) 2020-01-24 12:49:56 -08:00
.gitignore Java SDK with all features implemented for milestone 0.4 (#154) 2020-01-24 12:49:56 -08:00
.gitmodules Renames project to . Fixes examples. Adds proto files from release-0.3. 2019-12-05 18:30:13 -08:00
CONTRIBUTING.md Adding Contribution guidance in java sdk repo 2019-10-15 17:53:20 -07:00
LICENSE Initial commit 2019-10-09 10:30:20 -07:00
README.md Java SDK with all features implemented for milestone 0.4 (#154) 2020-01-24 12:49:56 -08:00
checkstyle.xml Java SDK with all features implemented for milestone 0.4 (#154) 2020-01-24 12:49:56 -08:00
pom.xml Java SDK with all features implemented for milestone 0.4 (#154) 2020-01-24 12:49:56 -08:00
settings.xml Java SDK with all features implemented for milestone 0.4 (#154) 2020-01-24 12:49:56 -08:00

README.md

Dapr SDK for Java

This is the Dapr SDK for Java, based on the auto-generated proto client.

For more info on Dapr and gRPC, visit this link.

Installing

Clone this repository including the submodules:

git clone https://github.com/dapr/java-sdk.git

Then head over to build the Maven (Apache Maven version 3.x) project:

# make sure you are in the `java-sdk` directory.
mvn install

Running the examples

Try the following examples to learn more about Dapr's Java SDK:

Creating and publishing the artifacts to Nexus Repository

From the root directory:

mvn package
mvn deploy:deploy-file -DgeneratePom=false -DrepositoryId=nexus -Durl=http://localhost:8081/repository/maven-releases -DpomFile=pom.xml -Dfile=target/client-0.1.0-preview.jar

For more documentation reference :

https://maven.apache.org/plugins/maven-deploy-plugin

https://help.sonatype.com/repomanager3/user-interface/uploading-components

Maven Module version management

To increase the version of all modules and pom files, run the following commands:

mvn versions:set -DnewVersion="0.1.0-preview02"
mvn versions:commit

Debug Java application or Dapr's Java SDK

If you have a Java application or an issue on this SDK that needs to be debugged, run Dapr using a dummy command and start the application from your IDE (IntelliJ, for example). For Linux and MacOS:

dapr run --app-id testapp --app-port 3000 --port 3500 --grpc-port 5001-- cat

For Windows:

dapr run --app-id testapp --app-port 3000 --port 3500 --grpc-port 5001 -- waitfor FOREVER

When running your Java application from IDE, make sure the following environment variables are set, so the Java SDK knows how to connect to Dapr's sidecar:

DAPR_HTTP_PORT=3500
DAPR_GRPC_PORT=5001

Now you can go to your IDE (like IntelliJ, for example) and debug your Java application, using port 3500 to call Dapr while also listening to port 3000 to expose Dapr's callback endpoint.

Calls to Dapr's APIs on http://localhost:3500/* should work now and trigger breakpoints in your code.

If your application needs to suscribe to topics or register Actors in Dapr, for example, then start debugging your app first and run dapr with dummy command last.

If using Visual Studio Code, also consider this solution as well.