# REST API

Ignite提供了一个HTTP REST客户端,可以以REST的方式通过HTTP或者HTTPS协议与集群进行通信。REST API可以用于执行不同的操作,比如对缓存进行读/写,执行任务,获取各种指标等等。

从内部来说,Ignite使用Jetty来提供HTTP服务,关于如何配置Jetty,请参见下面的配置章节的介绍。

# 1.入门

要启用HTTP连接,确保在类路径中包含ignite-rest-http模块,在二进制包中,这意味着将其从IGNITE_HOME/libs/optional/拷贝到IGNITE_HOME/libs中,具体请参见启用模块章节的介绍。

不需要特别的配置,连接器就会自动启动,然后监听8080端口,可以通过curl检测其是否工作正常:

curl 'http://localhost:8080/ignite?cmd=version'

请求参数可以通过URL传递,也可以通过表单数据提交方式传递:

curl 'http://localhost:8080/ignite?cmd=put&cacheName=myCache' -X POST -H 'Content-Type: application/x-www-form-urlencoded' -d 'key=testKey&val=testValue'

# 1.1.配置

修改HTTP服务器参数的方法如下: