You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The official Java SDK for the Sovren v10 API for resume/CV and job parsing, searching, and matching. Supports Java 1.8+.
6
+
The official Java SDK for the Textkernel Tx v10 API for resume/CV and job parsing, searching, and matching. Supports Java 1.8+.
7
7
8
8
## Installation
9
9
@@ -13,22 +13,22 @@ The official Java SDK for the Sovren v10 API for resume/CV and job parsing, sear
13
13
### Gradle Users
14
14
Add this dependency to your project's build file:
15
15
```
16
-
implementation "com.sovren:sovren-java:1.10.0"
16
+
implementation "com.textkernel:tx-java:2.0.0"
17
17
```
18
18
19
19
### Maven Users
20
20
Add this dependency to your project's POM:
21
21
```xml
22
22
<dependency>
23
-
<groupId>com.sovren</groupId>
24
-
<artifactId>sovren-java</artifactId>
25
-
<version>1.10.0</version>
23
+
<groupId>com.textkernel</groupId>
24
+
<artifactId>tx-java</artifactId>
25
+
<version>2.0.0</version>
26
26
</dependency>
27
27
```
28
28
29
29
### Others
30
30
You'll need to manually install the following JARs:
31
-
- The Sovren JAR from https://repo1.maven.org/maven2/com/sovren/sovren-java/1.10.0/sovren-java-1.10.0.jar
31
+
- The Textkernel Tx JAR from https://repo1.maven.org/maven2/com/textkernel/tx-java/2.0.0/tx-java-2.0.0.jar
32
32
-[Google Gson][gson_url] from https://repo1.maven.org/maven2/com/google/code/gson/gson/2.9.0/gson-2.9.0.jar
33
33
-[Square OkHttp][okhttp_url] from https://repo1.maven.org/maven2/com/squareup/okhttp3/okhttp/4.9.3/okhttp-4.9.3.jar
34
34
@@ -43,39 +43,39 @@ For full code examples, see [here][examples].
43
43
44
44
## Usage
45
45
46
-
### Creating a `SovrenClient`
47
-
This is the object that you will use to perform API calls. You create it with your account credentials and the `SovrenClient` makes the raw API calls for you. These credentials can be found in the [Sovren Portal][portal]. Be sure to select the correct `DataCenter` for your account.
46
+
### Creating a `TxClient`
47
+
This is the object that you will use to perform API calls. You create it with your account credentials and the `TxClient` makes the raw API calls for you. These credentials can be found in the [Tx Console][portal]. Be sure to select the correct `DataCenter` for your account.
For self-hosted customers, you can create a `DataCenter` object with your custom URL using the constructor provided on that class.
53
53
54
-
### Handling errors and the `SovrenException`
55
-
Every call to any of the methods in the `SovrenClient` should be wrapped in a `try/catch` block. Any 4xx/5xx level errors will cause a `SovrenException` to be thrown. Sometimes these are a normal and expected part of the Sovren API. For example, if you have a website where users upload resumes, sometimes a user will upload a scanned image as their resume. Sovren does not process these, and will return a `422 Unprocessable Entity` response which will throw a `SovrenException`. You should handle any `SovrenException` in a way that makes sense in your application.
54
+
### Handling errors and the `TxException`
55
+
Every call to any of the methods in the `TxClient` should be wrapped in a `try/catch` block. Any 4xx/5xx level errors will cause a `TxException` to be thrown. Sometimes these are a normal and expected part of the Tx API. For example, if you have a website where users upload resumes, sometimes a user will upload a scanned image as their resume. Textkernel does not process these, and will return a `422 Unprocessable Entity` response which will throw a `TxException`. You should handle any `TxException` in a way that makes sense in your application.
56
56
57
-
Additionally, there are `SovrenUsableResumeException` and `SovrenUsableJobException` which are thrown when some error/issue occurs in the API, but the response still contains a usable resume/job. For example, if you are geocoding while parsing and there is a geocoding error (which happens after parsing is done), the `ParsedResume` might still be usable in your application.
57
+
Additionally, there are `TxUsableResumeException` and `TxUsableJobException` which are thrown when some error/issue occurs in the API, but the response still contains a usable resume/job. For example, if you are geocoding while parsing and there is a geocoding error (which happens after parsing is done), the `ParsedResume` might still be usable in your application.
58
58
59
59
### How to create a Matching UI session
60
60
You may be wondering, "where are the Matching UI endpoints/methods?". We have made the difference between a normal API call (such as `Search`) and its equivalent Matching UI call extremely trivial. See the following example:
To generate a Matching UI session with the above Search query, you simply need to call the `ui(...)` method on the `SovrenClient` object, pass in any UI settings, and then make the same call as above:
69
+
To generate a Matching UI session with the above Search query, you simply need to call the `ui(...)` method on the `TxClient` object, pass in any UI settings, and then make the same call as above:
0 commit comments