ServiceTalk是一个JVM网络应用程序框架，具有针对特定协议量身定制的API- app开发者内容

ServiceTalk是一个JVM网络应用程序框架，具有针对特定协议量身定制的API

网友投稿 1008 2022-10-12 15:42:01

ServiceTalk是一个JVM网络应用程序框架，具有针对特定协议量身定制的API

ServiceTalk

Getting Started

ServiceTalk releases are available on Maven Central.

For Gradle as well as other build tools that don’t use Maven Central as a default repository, additional configuration is required.

Gradle, build.gradle

repositories {  jcenter() // combines Maven Central and other popular repositories}

Refer to the ServiceTalk docs for various examples that will get you started with the different features of ServiceTalk.

Note	Builds of the development version are available in Sonatype’s snapshots Maven repository.

Supported JVMThe minimum supported JDK version is 1.8.

Compatibility

ServiceTalk follows SemVer 2.0.0. API/ABI breaking changes will require package renaming for that module to avoid runtime classpath conflicts.

Note	`0.x.y` releases are not stable and are permitted to break API/ABI.

Contributor Setup

Important	If you’re intending to contribute to ServiceTalk, make sure to first read the contribution guidelines.

ServiceTalk uses Gradle as its build tool and only requires JDK 8 or higher to be pre-installed. ServiceTalk ships with the Gradle Wrapper, which means that there is no need to install Gradle on your machine beforehand.

File Encoding

ServiceTalk’s source code is UTF-8 encoded: make sure your filesystem supports it before attempting to build the project. Setting the JAVA_TOOL_OPTIONS env var to -Dfile.encoding=UTF-8 should help building the project in non-UTF-8 environments. Editors and IDEs must also support UTF-8 in order to successfully edit ServiceTalk’s source code.

Gradle Repositories

ServiceTalk’s build produces custom Gradle plugins and thus has regular (i.e. non-buildscript) dependencies on other plugins. This is the reason why the repositories that are provided if none are configured globally are the following:

allprojects {  buildscript {    repositories {      jcenter()      maven { url "https://plugins.gradle.org/m2/" }    }  }  repositories {    jcenter()    maven { url "https://plugins.gradle.org/m2/" }  }}

If you have defined repositories or repository mirrors in your global Gradle config (~/.gradle/init.gradle), the build will detect them and attempt to inherit buildscript repositories into the main repositories of the sub-projects that produce custom Gradle plugins.

Note	This inheritance mechanism can be disabled by setting a Gradle property: `-PdisableInheritBuildscriptRepositories`.

Build Commands

You should be able to run the following command to build ServiceTalk:

$ ./gradlew build

The supported IDE is IntelliJ IDEA. In order to generate IntelliJ IDEA project files for ServiceTalk, you can run the following command:

$ ./gradlew idea

When done, running one of following commands would open ServiceTalk in IntelliJ:

Generic

$ idea .

macOS

$ open servicetalk.ipr

Project CommunicationWe encourage your participation asking questions and helping improve the ServiceTalk project. Github issues and pull requests are the primary mechanisms of participation and communication for ServiceTalk.