2.16. RESTEasy 작업 서비스

web.xml 파일에서 비동기 작업 서비스를 활성화합니다.

<context-param>
    <param-name>resteasy.async.job.service.enabled</param-name>
    <param-value>true</param-value>
</context-param>

이 섹션에서는 RESTEasy를 사용한 비동기 작업에 대한 쿼리 매개 변수의 예를 설명합니다.

asynch 쿼리 매개 변수는 백그라운드에서 호출을 실행하는 데 사용됩니다. 202 Accepted 응답이 반환되고, 백그라운드 메서드의 응답이 있는 위치를 가리키는 URL이 있는 위치 헤더가 반환됩니다.

POST http://example.com/myservice?asynch=true

위의 예제에서는 202 Accepted 응답을 반환합니다. 또한 백그라운드 메서드의 응답이 있는 위치를 가리키는 URL이 있는 위치 헤더를 반환합니다. 위치 헤더의 예는 다음과 같습니다.

HTTP/1.1 202 Accepted
Location: http://example.com/asynch/jobs/3332334

URI는 다음과 같은 형식을 사용합니다.

/asynch/jobs/{job-id}?wait={milliseconds}|nowait=true

GET, POST 및 DELETE 작업은 이 URL에서 수행할 수 있습니다.

GET 및 POST 작업을 사용하면 wait 및 nowait 쿼리 매개변수를 사용하여 최대 대기 시간을 정의할 수 있습니다. wait 매개변수를 지정하지 않으면 작업이 기본적으로 nowait=true 로 설정되며 작업이 완료되지 않은 경우 전혀 대기하지 않습니다. wait 매개 변수는 밀리초 단위로 정의됩니다.

POST http://example.com/asynch/jobs/122?wait=3000

RESTEasy는 oneway 쿼리 매개 변수를 사용하여 fire 및 forget 작업을 지원합니다.

POST http://example.com/myservice?oneway=true

위의 예제에서는 202 Accepted 응답을 반환하지만 작업이 생성되지 않습니다.