diff --git a/README.md b/README.md
index b7e10be5c..d7a17b7d9 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,11 @@ This is the Dapr SDK for Java, including the following features:
### Getting Started
#### Pre-Requisites
+* JDK 8 or above:
+ * [Oracle's JDK 15](https://www.oracle.com/java/technologies/javase-jdk15-downloads.html)
+ * [Oracle's JDK 11 - LTS](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html)
+ * [Oracle's JDK 8](https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html)
+ * [OpenJDK](https://openjdk.java.net/)
* Java IDE installed:
* [IntelliJ](https://www.jetbrains.com/idea/download/)
* [Eclipse](https://www.eclipse.org/downloads/)
@@ -55,36 +60,29 @@ For a Maven project, add the following to your `pom.xml` file:
...
...
-
-
- ...
-
-
- io.dapr
- dapr-sdk
- 0.10.0
-
-
-
- io.dapr
- dapr-sdk-actors
- 0.10.0
-
-
-
- io.dapr
- dapr-sdk-springboot
- 0.10.0
-
-
-
- com.squareup.okhttp3
- okhttp
- 4.2.2
-
- ...
-
-
+
+ ...
+
+
+ io.dapr
+ dapr-sdk
+ 1.0.0
+
+
+
+ io.dapr
+ dapr-sdk-actors
+ 1.0.0
+
+
+
+ io.dapr
+ dapr-sdk-springboot
+ 1.0.0
+
+ ...
+
+ ...
```
@@ -108,16 +106,11 @@ repositories {
dependencies {
...
// Dapr's core SDK with all features, except Actors.
- compile('io.dapr:dapr-sdk:0.10.0')
+ compile('io.dapr:dapr-sdk:1.0.0')
// Dapr's SDK for Actors (optional).
- compile('io.dapr:dapr-sdk-actors:0.10.0')
+ compile('io.dapr:dapr-sdk-actors:1.0.0')
// Dapr's SDK integration with SpringBoot (optional).
- compile('io.dapr:dapr-sdk-springboot:0.10.0')
-
- // If needed, force conflict resolution for okhttp3.
- configurations.all {
- resolutionStrategy.force 'com.squareup.okhttp3:okhttp:4.2.2'
- }
+ compile('io.dapr:dapr-sdk-springboot:1.0.0')
}
```
@@ -189,9 +182,11 @@ This SDK provides a basic serialization for request/response objects but also fo
```
* When building a new instance of [ActorProxy](https://dapr.github.io/java-sdk/io/dapr/actors/client/ActorProxy.html) to invoke an Actor instance, use the same serializer as when registering the Actor Type:
```java
- ActorProxy actor = (new ActorProxyBuilder("DemoActor"))
- .withObjectSerializer(new MyObjectSerializer()) // for request/response objects.
- .build();
+ try (ActorClient actorClient = new ActorClient()) {
+ DemoActor actor = (new ActorProxyBuilder(DemoActor.class, actorClient))
+ .withObjectSerializer(new MyObjectSerializer()) // for request/response objects.
+ .build(new ActorId("100"));
+ }
```
@@ -201,17 +196,14 @@ This SDK provides a basic serialization for request/response objects but also fo
**In Visual Studio Code, consider [debugging in Visual Studio Code](https://docs.dapr.io/developing-applications/ides/vscode-debugging/).**
-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).
+If you need to debug your Application, run Dapr sidecar separately and then start the application from your IDE (IntelliJ, for example).
For Linux and MacOS:
```sh
-dapr run --app-id testapp --app-port 3000 --dapr-http-port 3500 --dapr-grpc-port 5001 -- cat
+dapr run --app-id testapp --app-port 3000 --dapr-http-port 3500 --dapr-grpc-port 5001
```
-For Windows:
-```sh
-dapr run --app-id testapp --app-port 3000 --dapr-http-port 3500 --dapr-grpc-port 5001 -- waitfor FOREVER
-```
+> Note: confirm the correct port that the app will listen to and that the Dapr ports above are free, changing the ports if necessary.
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:
```
@@ -221,25 +213,23 @@ DAPR_GRPC_PORT=5001
Now you can go to your IDE (like Eclipse, 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://127.0.0.1:3500/*` should work now and trigger breakpoints in your code.
-
#### Exception handling
-All exceptions thrown from the SDK are instances of `DaprException`. `DaprException` extends from `RuntimeException`, making it compatible with Project Reactor. See [example](./examples/src/main/java/io/dapr/examples/exception) for more details.
+Most exceptions thrown from the SDK are instances of `DaprException`. `DaprException` extends from `RuntimeException`, making it compatible with Project Reactor. See [example](./examples/src/main/java/io/dapr/examples/exception) for more details.
### Development
#### Update proto files
-Change the properties below in [pom.xml](./pom.xml) to point to the desired reference URL in Git. Avoid pointing to master branch since it can change over time and create unpredictable behavior in the build.
+Change the properties below in [pom.xml](./pom.xml) to point to the desired reference URL in Git. Avoid pointing to `master` branch since it can change over time and create unpredictable behavior in the build.
```xml
...
...
- https://raw.githubusercontent.com/dapr/dapr/v0.4.0/pkg/proto/dapr/dapr.proto
- https://raw.githubusercontent.com/dapr/dapr/v0.4.0/pkg/proto/daprclient/daprclient.proto
+ https://raw.githubusercontent.com/dapr/dapr/v1.0.0/pkg/proto/dapr/dapr.proto
+ https://raw.githubusercontent.com/dapr/dapr/v1.0.0/pkg/proto/daprclient/daprclient.proto
...
...
diff --git a/docs/allclasses-index.html b/docs/allclasses-index.html
index e03596f76..663d617da 100644
--- a/docs/allclasses-index.html
+++ b/docs/allclasses-index.html
@@ -2,10 +2,10 @@
-
-All Classes (dapr-sdk-parent 0.10.0 API)
+
+All Classes (dapr-sdk-parent 1.0.0 API)
-
+
@@ -20,7 +20,7 @@
-
Returns the enum constant of this type with the specified name.
+The string must match exactly an identifier used to declare an
+enum constant in this type. (Extraneous whitespace characters are
+not permitted.)
+
+
Parameters:
+
name - the name of the enum constant to be returned.
diff --git a/docs/io/dapr/client/class-use/DaprHttp.HttpMethods.html b/docs/io/dapr/client/class-use/DaprHttp.HttpMethods.html
index 77cdba264..9c66bfe91 100644
--- a/docs/io/dapr/client/class-use/DaprHttp.HttpMethods.html
+++ b/docs/io/dapr/client/class-use/DaprHttp.HttpMethods.html
@@ -2,10 +2,10 @@
-
-Uses of Class io.dapr.client.DaprHttp.HttpMethods (dapr-sdk-parent 0.10.0 API)
+
+Uses of Class io.dapr.client.DaprHttp.HttpMethods (dapr-sdk-parent 1.0.0 API)
-
+
@@ -164,8 +164,15 @@ the order they are declared.
diff --git a/docs/io/dapr/client/domain/class-use/StateOptions.Concurrency.html b/docs/io/dapr/client/domain/class-use/StateOptions.Concurrency.html
index b588e3b26..9428b340e 100644
--- a/docs/io/dapr/client/domain/class-use/StateOptions.Concurrency.html
+++ b/docs/io/dapr/client/domain/class-use/StateOptions.Concurrency.html
@@ -2,10 +2,10 @@
-
-Uses of Class io.dapr.client.domain.StateOptions.Concurrency (dapr-sdk-parent 0.10.0 API)
+
+Uses of Class io.dapr.client.domain.StateOptions.Concurrency (dapr-sdk-parent 1.0.0 API)
-
+
@@ -185,7 +185,7 @@ the order they are declared.
-
diff --git a/docs/io/dapr/client/domain/class-use/StateOptions.Consistency.html b/docs/io/dapr/client/domain/class-use/StateOptions.Consistency.html
index 9bc77de1f..13af9bd37 100644
--- a/docs/io/dapr/client/domain/class-use/StateOptions.Consistency.html
+++ b/docs/io/dapr/client/domain/class-use/StateOptions.Consistency.html
@@ -2,10 +2,10 @@
-
-Uses of Class io.dapr.client.domain.StateOptions.Consistency (dapr-sdk-parent 0.10.0 API)
+
+Uses of Class io.dapr.client.domain.StateOptions.Consistency (dapr-sdk-parent 1.0.0 API)
-
+
@@ -185,7 +185,7 @@ the order they are declared.
-
diff --git a/docs/io/dapr/client/domain/class-use/TransactionalStateOperation.OperationType.html b/docs/io/dapr/client/domain/class-use/TransactionalStateOperation.OperationType.html
index 0f2a9db32..aa79dba9b 100644
--- a/docs/io/dapr/client/domain/class-use/TransactionalStateOperation.OperationType.html
+++ b/docs/io/dapr/client/domain/class-use/TransactionalStateOperation.OperationType.html
@@ -2,10 +2,10 @@
-
-Uses of Class io.dapr.client.domain.TransactionalStateOperation.OperationType (dapr-sdk-parent 0.10.0 API)
+
+Uses of Class io.dapr.client.domain.TransactionalStateOperation.OperationType (dapr-sdk-parent 1.0.0 API)
-
+
@@ -180,7 +180,7 @@ the order they are declared.
public static final class DaprProtos.ActiveActorsCount
+extends com.google.protobuf.GeneratedMessageV3
+implements DaprProtos.ActiveActorsCountOrBuilder
+
Protobuf type dapr.proto.runtime.v1.ActiveActorsCount
public static final class DaprProtos.GetMetadataResponse
+extends com.google.protobuf.GeneratedMessageV3
+implements DaprProtos.GetMetadataResponseOrBuilder
+
+ GetMetadataResponse is a message that is returned on GetMetadata rpc call
+
+
+ Protobuf type dapr.proto.runtime.v1.GetMetadataResponse
public static final class DaprProtos.SetMetadataRequest
+extends com.google.protobuf.GeneratedMessageV3
+implements DaprProtos.SetMetadataRequestOrBuilder
+
Protobuf type dapr.proto.runtime.v1.SetMetadataRequest
diff --git a/docs/io/dapr/v1/class-use/CommonProtos.HTTPExtension.Verb.html b/docs/io/dapr/v1/class-use/CommonProtos.HTTPExtension.Verb.html
index a4dc0cedc..ed46d8243 100644
--- a/docs/io/dapr/v1/class-use/CommonProtos.HTTPExtension.Verb.html
+++ b/docs/io/dapr/v1/class-use/CommonProtos.HTTPExtension.Verb.html
@@ -2,10 +2,10 @@
-
-Uses of Class io.dapr.v1.CommonProtos.HTTPExtension.Verb (dapr-sdk-parent 0.10.0 API)
+
+Uses of Class io.dapr.v1.CommonProtos.HTTPExtension.Verb (dapr-sdk-parent 1.0.0 API)
-
+
@@ -239,7 +239,7 @@ the order they are declared.
-
diff --git a/docs/io/dapr/v1/class-use/CommonProtos.StateOptions.StateConcurrency.html b/docs/io/dapr/v1/class-use/CommonProtos.StateOptions.StateConcurrency.html
index be5267962..c10acb33f 100644
--- a/docs/io/dapr/v1/class-use/CommonProtos.StateOptions.StateConcurrency.html
+++ b/docs/io/dapr/v1/class-use/CommonProtos.StateOptions.StateConcurrency.html
@@ -2,10 +2,10 @@
-
-Uses of Class io.dapr.v1.CommonProtos.StateOptions.StateConcurrency (dapr-sdk-parent 0.10.0 API)
+
+Uses of Class io.dapr.v1.CommonProtos.StateOptions.StateConcurrency (dapr-sdk-parent 1.0.0 API)
-
+
@@ -235,7 +235,7 @@ the order they are declared.
diff --git a/docs/io/dapr/v1/class-use/CommonProtos.StateOptions.StateConsistency.html b/docs/io/dapr/v1/class-use/CommonProtos.StateOptions.StateConsistency.html
index ca39c0eae..f059aebb9 100644
--- a/docs/io/dapr/v1/class-use/CommonProtos.StateOptions.StateConsistency.html
+++ b/docs/io/dapr/v1/class-use/CommonProtos.StateOptions.StateConsistency.html
@@ -2,10 +2,10 @@
-
-Uses of Class io.dapr.v1.CommonProtos.StateOptions.StateConsistency (dapr-sdk-parent 0.10.0 API)
+
+Uses of Class io.dapr.v1.CommonProtos.StateOptions.StateConsistency (dapr-sdk-parent 1.0.0 API)
-
+
@@ -267,7 +267,7 @@ the order they are declared.
-
diff --git a/docs/io/dapr/v1/class-use/DaprAppCallbackProtos.BindingEventResponse.BindingEventConcurrency.html b/docs/io/dapr/v1/class-use/DaprAppCallbackProtos.BindingEventResponse.BindingEventConcurrency.html
index 1ca389679..037733c2e 100644
--- a/docs/io/dapr/v1/class-use/DaprAppCallbackProtos.BindingEventResponse.BindingEventConcurrency.html
+++ b/docs/io/dapr/v1/class-use/DaprAppCallbackProtos.BindingEventResponse.BindingEventConcurrency.html
@@ -2,10 +2,10 @@
-
-Uses of Class io.dapr.v1.DaprAppCallbackProtos.BindingEventResponse.BindingEventConcurrency (dapr-sdk-parent 0.10.0 API)
+
+Uses of Class io.dapr.v1.DaprAppCallbackProtos.BindingEventResponse.BindingEventConcurrency (dapr-sdk-parent 1.0.0 API)
-
+
@@ -243,7 +243,7 @@ the order they are declared.
-
- TopicEventRequest message is compatiable with CloudEvent spec v1.0
+ TopicEventRequest message is compatible with CloudEvent spec v1.0
https://github.com/cloudevents/spec/blob/v1.0/spec.md
- TopicEventRequest message is compatiable with CloudEvent spec v1.0
+ TopicEventRequest message is compatible with CloudEvent spec v1.0
https://github.com/cloudevents/spec/blob/v1.0/spec.md
diff --git a/docs/io/dapr/v1/class-use/DaprAppCallbackProtos.TopicEventResponse.TopicEventResponseStatus.html b/docs/io/dapr/v1/class-use/DaprAppCallbackProtos.TopicEventResponse.TopicEventResponseStatus.html
index 9cacea5ed..183c4e44d 100644
--- a/docs/io/dapr/v1/class-use/DaprAppCallbackProtos.TopicEventResponse.TopicEventResponseStatus.html
+++ b/docs/io/dapr/v1/class-use/DaprAppCallbackProtos.TopicEventResponse.TopicEventResponseStatus.html
@@ -2,10 +2,10 @@
-
-Uses of Class io.dapr.v1.DaprAppCallbackProtos.TopicEventResponse.TopicEventResponseStatus (dapr-sdk-parent 0.10.0 API)
+
+Uses of Class io.dapr.v1.DaprAppCallbackProtos.TopicEventResponse.TopicEventResponseStatus (dapr-sdk-parent 1.0.0 API)
-
+
@@ -239,7 +239,7 @@ the order they are declared.
-
- TopicEventRequest message is compatiable with CloudEvent spec v1.0
+ TopicEventRequest message is compatible with CloudEvent spec v1.0
https://github.com/cloudevents/spec/blob/v1.0/spec.md
- TopicEventRequest message is compatiable with CloudEvent spec v1.0
+ TopicEventRequest message is compatible with CloudEvent spec v1.0
https://github.com/cloudevents/spec/blob/v1.0/spec.md
- TopicEventRequest message is compatiable with CloudEvent spec v1.0
+ TopicEventRequest message is compatible with CloudEvent spec v1.0
https://github.com/cloudevents/spec/blob/v1.0/spec.md