dapr
/
java-sdk
mirror of https://github.com/dapr/java-sdk.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Dapr SDK for Java
121 Commits 47 Branches 91 Tags 131 MiB
Java 99.9%
Shell 0.1%
Go to file
Marcos Reyes de1ab57b6c Adding documentation for examples (#153) 2020-01-24 12:36:49 -08:00
.github Install local test kafka before running build and tests (#142) 2020-01-22 13:50:39 -08:00
examples Adding documentation for examples (#153) 2020-01-24 12:36:49 -08:00
proto Starting package to handle SpringBoot integration. (#69) 2020-01-07 14:22:30 -08:00
sdk Add E2E testing for bindings (#148) 2020-01-24 11:59:05 -08:00
sdk-actors Adding checkstyle + fix style in sdk-actos. (#146) 2020-01-24 11:32:56 -08:00
sdk-autogen Deploy Jar packages to Nexus via CI (#106) 2020-01-16 11:06:42 -08:00
.gitignore Basic Dapr HTTP Client for Actors. 2019-12-10 23:35:25 -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 Update debug instructions since LB is not needed. (#150) 2020-01-24 11:40:20 -08:00
checkstyle.xml Adding checkstyle + fix style in sdk-actos. (#146) 2020-01-24 11:32:56 -08:00
pom.xml Add E2E testing for bindings (#148) 2020-01-24 11:59:05 -08:00
settings.xml [CD] Fix gpg private key import (#113) 2020-01-16 16:23:57 -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.