|
1 |
| -# Network Security API Client for Java |
| 1 | +# Google Network Security API Client for Java |
2 | 2 |
|
3 | 3 | Java idiomatic client for [Network Security API][product-docs].
|
4 | 4 |
|
@@ -20,18 +20,18 @@ If you are using Maven, add this to your pom.xml file:
|
20 | 20 | <dependency>
|
21 | 21 | <groupId>com.google.cloud</groupId>
|
22 | 22 | <artifactId>google-cloud-network-security</artifactId>
|
23 |
| -<version>0.0.0</version> |
| 23 | +<version>0.1.0</version> |
24 | 24 | </dependency>
|
25 | 25 | ```
|
26 | 26 |
|
27 | 27 | If you are using Gradle without BOM, add this to your dependencies
|
28 | 28 | ```Groovy
|
29 |
| -compile 'com.google.cloud:google-cloud-network-security:0.0.0' |
| 29 | +compile 'com.google.cloud:google-cloud-network-security:0.1.0' |
30 | 30 | ```
|
31 | 31 |
|
32 | 32 | If you are using SBT, add this to your dependencies
|
33 | 33 | ```Scala
|
34 |
| -libraryDependencies += "com.google.cloud" % "google-cloud-network-security" % "0.0.0" |
| 34 | +libraryDependencies += "com.google.cloud" % "google-cloud-network-security" % "0.1.0" |
35 | 35 | ```
|
36 | 36 |
|
37 | 37 | ## Authentication
|
@@ -43,7 +43,7 @@ See the [Authentication][authentication] section in the base directory's README.
|
43 | 43 | ### Prerequisites
|
44 | 44 |
|
45 | 45 | You will need a [Google Cloud Platform Console][developer-console] project with the Network Security API [API enabled][enable-api].
|
46 |
| -You will need to [enable billing][enable-billing] to use Network Security API. |
| 46 | +You will need to [enable billing][enable-billing] to use Google Network Security API. |
47 | 47 | [Follow these instructions][create-project] to get your project set up. You will also need to set up the local development environment by
|
48 | 48 | [installing the Google Cloud SDK][cloud-sdk] and running the following commands in command line:
|
49 | 49 | `gcloud auth login` and `gcloud config set project [YOUR PROJECT ID]`.
|
@@ -56,11 +56,16 @@ to add `google-cloud-network-security` as a dependency in your code.
|
56 | 56 | ## About Network Security API
|
57 | 57 |
|
58 | 58 |
|
59 |
| -n/a |
| 59 | +[Network Security API][product-docs] n/a |
60 | 60 |
|
61 | 61 | See the [Network Security API client library docs][javadocs] to learn how to
|
62 | 62 | use this Network Security API Client Library.
|
63 | 63 |
|
| 64 | + |
| 65 | + |
| 66 | + |
| 67 | + |
| 68 | + |
64 | 69 | ## Troubleshooting
|
65 | 70 |
|
66 | 71 | To get help, follow the instructions in the [shared Troubleshooting document][troubleshooting].
|
@@ -69,10 +74,50 @@ To get help, follow the instructions in the [shared Troubleshooting document][tr
|
69 | 74 |
|
70 | 75 | Network Security API uses gRPC for the transport layer.
|
71 | 76 |
|
72 |
| -## Java Versions |
| 77 | +## Supported Java Versions |
73 | 78 |
|
74 | 79 | Java 7 or above is required for using this client.
|
75 | 80 |
|
| 81 | +Google's Java client libraries, |
| 82 | +[Google Cloud Client Libraries][cloudlibs] |
| 83 | +and |
| 84 | +[Google Cloud API Libraries][apilibs], |
| 85 | +follow the |
| 86 | +[Oracle Java SE support roadmap][oracle] |
| 87 | +(see the Oracle Java SE Product Releases section). |
| 88 | + |
| 89 | +### For new development |
| 90 | + |
| 91 | +In general, new feature development occurs with support for the lowest Java |
| 92 | +LTS version covered by Oracle's Premier Support (which typically lasts 5 years |
| 93 | +from initial General Availability). If the minimum required JVM for a given |
| 94 | +library is changed, it is accompanied by a [semver][semver] major release. |
| 95 | + |
| 96 | +Java 11 and (in September 2021) Java 17 are the best choices for new |
| 97 | +development. |
| 98 | + |
| 99 | +### Keeping production systems current |
| 100 | + |
| 101 | +Google tests its client libraries with all current LTS versions covered by |
| 102 | +Oracle's Extended Support (which typically lasts 8 years from initial |
| 103 | +General Availability). |
| 104 | + |
| 105 | +#### Legacy support |
| 106 | + |
| 107 | +Google's client libraries support legacy versions of Java runtimes with long |
| 108 | +term stable libraries that don't receive feature updates on a best efforts basis |
| 109 | +as it may not be possible to backport all es. |
| 110 | + |
| 111 | +Google provides updates on a best efforts basis to apps that continue to use |
| 112 | +Java 7, though apps might need to upgrade to current versions of the library |
| 113 | +that supports their JVM. |
| 114 | + |
| 115 | +#### Where to find specific information |
| 116 | + |
| 117 | +The latest versions and the supported Java versions are identified on |
| 118 | +the individual repository `.com/GoogleAPIs/java-SERVICENAME` |
| 119 | +and on [google-cloud-java][g-c-j]. |
| 120 | + |
76 | 121 | ## Versioning
|
77 | 122 |
|
78 | 123 |
|
@@ -109,7 +154,7 @@ Java 11 | [![Kokoro CI][kokoro-badge-image-5]][kokoro-badge-link-5]
|
109 | 154 |
|
110 | 155 | Java is a registered trademark of Oracle and/or its affiliates.
|
111 | 156 |
|
112 |
| -[product-docs]: https://cloud.google.com/network-security/docs/ |
| 157 | +[product-docs]: https://cloud.google.com/traffic-director/docs/reference/network-security/rest |
113 | 158 | [javadocs]: https://googleapis.dev/java/google-cloud-network-security/latest/index.html
|
114 | 159 | [kokoro-badge-image-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-network-security/java7.svg
|
115 | 160 | [kokoro-badge-link-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-network-security/java7.html
|
@@ -133,6 +178,12 @@ Java is a registered trademark of Oracle and/or its affiliates.
|
133 | 178 | [code-of-conduct]: https://.com/googleapis/java-network-security/blob/master/CODE_OF_CONDUCT.md#contributor-code-of-conduct
|
134 | 179 | [license]: https://.com/googleapis/java-network-security/blob/master/LICENSE
|
135 | 180 | [enable-billing]: https://cloud.google.com/apis/docs/getting-started#enabling_billing
|
136 |
| -[enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=network-security.googleapis.com |
| 181 | +[enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=networksecurity.googleapis.com |
137 | 182 | [libraries-bom]: https://.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
|
138 |
| -[shell_img]: https://gstatic.com/cloudssh/images/open-btn.png |
| 183 | +[shell_img]: https://gstatic.com/cloudssh/images/open-btn.png |
| 184 | + |
| 185 | +[semver]: https://semver.org/ |
| 186 | +[cloudlibs]: https://cloud.google.com/apis/docs/client-libraries-explained |
| 187 | +[apilibs]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries |
| 188 | +[oracle]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html |
| 189 | +[g-c-j]: http://.com/googleapis/google-cloud-java |
0 commit comments