当我们定义一个 Ratpack 应用程序时,我们可以在服务器配置代码中设置一个服务器端口。当我们没有在代码中定义端口号并使用默认服务器配置时,我们还可以使用环境变量
PORT
或
RATPACK_PORT
设置服务器端口。
在下面的示例中,我们使用 Gradle 作为构建工具来运行我们的 Ratpack 应用程序。 Gradle 会将环境变量传递给
run
任务。我们使用环境变量
RATPACK_PORT
将端口更改为
9000
:
$ RATPACK_PORT gradle run
Starting server...
Building registry...
Ratpack started (development) for http://localhost:9000
或者,我们可以在我们的配置中定义端口号,但也可以添加一个选项来支持环境变量来设置或覆盖配置属性。只需调用
ConfigDataBuilder
接口上的
env
方法即可添加此支持。使用此方法,Ratpack 会查找以
RATPACK_
开头的环境变量。然后解析环境变量的其余部分并将其转换为配置属性。双下划线用作部分之间的分隔符,单下划线用作驼峰式字段的边界。例如,环境变量
RATPACK_SERVER__PORT
转换为
server.port
。
$ RATPACK_PORT gradle run
Starting server...
Building registry...
Ratpack started (development) for http://localhost:9000
让我们运行我们的应用程序并使用环境变量
RATPACK_SERVER__PORT
来更改端口号:
$ RATPACK_PORT gradle run
Starting server...
Building registry...
Ratpack started (development) for http://localhost:9000
我们可以更改环境变量的默认前缀
RATPACK
。我们仍然使用方法
env
,但这次我们指定一个参数作为环境变量的前缀。在下面的代码中,我们看到如何使用前缀
COCKTAILS_
作为环境变量:
$ RATPACK_PORT gradle run
Starting server...
Building registry...
Ratpack started (development) for http://localhost:9000
让我们运行我们的应用程序并使用环境变量
COCKTAILS_SERVER__PORT
来更改端口号:
$ RATPACK_PORT gradle run
Starting server...
Building registry...
Ratpack started (development) for http://localhost:9000
用 Ratpack 1.0.0 编写。