RestConnectorClient 클래스

  • 참조
패키지:
com.microsoft.bot.connector.rest
Maven 아티팩트:
com.microsoft.bot:bot-connector:4.14.3

구현

ConnectorClient

public class RestConnectorClient
extends ServiceClient
implements ConnectorClient

Bot Connector REST API를 사용하면 봇이 [Bot Framework 개발자 포털](https://dev.botframework.com)에 구성된 채널로 메시지를 보내고 받을 수 있습니다. 커넥터 서비스는 HTTPS를 통해 업계 표준 REST 및 JSON을 사용합니다. 이 REST API에 대한 클라이언트 라이브러리를 사용할 수 있습니다. 목록은 아래를 참조하세요. 많은 봇은 Bot Connector REST API와 연결된 [Bot State REST API](/en-us/restapi/state)를 모두 사용합니다. 봇 상태 REST API를 사용하면 봇이 사용자 및 대화와 연결된 상태를 저장하고 검색할 수 있습니다. Bot Connector 및 Bot State REST API에 대한 인증은 JWT 전달자 토큰을 사용하여 수행되며 [커넥터 인증](/en-us/restapi/authentication) 문서에 자세히 설명되어 있습니다.

생성자 요약

생성자 Description
RestConnectorClient(RestClient restClient)

커넥터클라이언트 클라이언트의 인스턴스를 초기화합니다.
RestConnectorClient(ServiceClientCredentials credentials)

커넥터클라이언트 클라이언트의 인스턴스를 초기화합니다.
RestConnectorClient(String baseUrl, ServiceClientCredentials credentials)

커넥터클라이언트 클라이언트의 인스턴스를 초기화합니다.

메서드 요약

한정자 및 형식 메서드 및 설명
java.lang.String baseUrl()

이 ConnectorClient의 기본 URL을 반환합니다.
void close()

자동삭제 가능 닫기
ServiceClientCredentials credentials()

사용 중인 자격 증명을 반환합니다.
java.lang.String getAcceptLanguage()

응답에 대한 기본 설정 언어를 가져옵니다.
Attachments getAttachments()

해당 작업에 액세스할 Attachments 개체를 가져옵니다.
Conversations getConversations()

해당 작업에 액세스할 Conversations 개체를 가져옵니다.
static Builder getDefaultRestClientBuilder(String baseUrl, ServiceClientCredentials credentials)

RestClient를 만들기 위해 Azure 클라이언트가 수행하는 작업의 복사본입니다.
boolean getGenerateClientRequestId()

true로 설정하면 고유한 x-ms-client-request-id 값이 생성되고 각 요청에 포함됩니다.
int getLongRunningOperationRetryTimeout()

장기 실행 작업에 대한 재시도 시간 제한(초)을 가져옵니다.
RestClient getRestClient()

REST 클라이언트를 가져옵니다.
RetryStrategy getRestRetryStrategy()

Rest 재시도 전략을 가져옵니다.
java.lang.String getUserAgent()

클라이언트의 User-Agent 헤더를 가져옵니다.
protected void initialize()

생성 후 개체를 초기화합니다.
void setAcceptLanguage(String withAcceptLanguage)

응답에 대한 기본 설정 언어를 설정합니다.
void setGenerateClientRequestId(boolean requestId)

true로 설정하면 고유한 x-ms-client-request-id 값이 생성되고 각 요청에 포함됩니다.
void setLongRunningOperationRetryTimeout(int timeout)

장기 실행 작업의 재시도 시간 제한을 초 단위로 설정합니다.
void setRestRetryStrategy(RetryStrategy strategy)

Rest 재시도 전략을 설정합니다.
java.lang.String userAgent()

이는 AzureService클라이언트 버전을 재정의하기 위한 것입니다.

다음에서 상속된 메서드 ServiceClient

httpClient restClient retrofit serializerAdapter userAgent

다음에서 상속된 메서드 java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

생성자 세부 정보

RestConnectorClient

public RestConnectorClient(RestClient restClient)

ConnectorClient 클라이언트의 인스턴스를 초기화합니다.

매개 변수:

restClient - Azure에 연결할 REST 클라이언트입니다.

RestConnectorClient

public RestConnectorClient(ServiceClientCredentials credentials)

ConnectorClient 클라이언트의 인스턴스를 초기화합니다.

매개 변수:

credentials - Azure에 대한 관리 자격 증명

RestConnectorClient

public RestConnectorClient(String baseUrl, ServiceClientCredentials credentials)

ConnectorClient 클라이언트의 인스턴스를 초기화합니다.

매개 변수:

baseUrl - 호스트의 기본 URL
credentials - Azure에 대한 관리 자격 증명

메서드 세부 정보

baseUrl

public String baseUrl()

이 ConnectorClient의 기본 URL을 반환합니다.

반환:

기본 URL입니다.

close

public void close()

자동 검색 가능 닫기

credentials

public ServiceClientCredentials credentials()

사용 중인 자격 증명을 반환합니다.

반환:

사용 중인 ServiceClientCredentials입니다.

getAcceptLanguage

public String getAcceptLanguage()

응답에 대한 기본 설정 언어를 가져옵니다.

반환:

acceptLanguage 값입니다.

getAttachments

public Attachments getAttachments()

해당 작업에 액세스할 Attachments 개체를 가져옵니다.

반환:

Attachments 개체입니다.

getConversations

public Conversations getConversations()

해당 작업에 액세스할 Conversations 개체를 가져옵니다.

반환:

Conversations 개체입니다.

getDefaultRestClientBuilder

public static RestClient.Builder getDefaultRestClientBuilder(String baseUrl, ServiceClientCredentials credentials)

RestClient를 만들기 위해 Azure 클라이언트가 수행하는 작업의 복사본입니다. 그러면 앱이 사용자 지정 RestClient를 만들고 생성 중에 ConnectorClient에 제공할 수 있도록 RestClient.Builder가 반환됩니다. 이 중 한 가지 사용 사례는 RestClient에 프록시를 제공하는 것입니다. Java 시스템 속성을 통해 프록시 정보를 설정하는 것이 좋습니다.

매개 변수:

baseUrl - 서비스 엔드포인트
credentials - 인증 자격 증명.

반환:

RestClient.Builder입니다.

getGenerateClientRequestId

public boolean getGenerateClientRequestId()

true로 설정하면 고유한 x-ms-client-request-id 값이 생성되고 각 요청에 포함됩니다.

반환:

generateClientRequestId 값입니다.

getLongRunningOperationRetryTimeout

public int getLongRunningOperationRetryTimeout()

장기 실행 작업에 대한 재시도 시간 제한(초)을 가져옵니다. 기본값은 30입니다.

반환:

시간 제한 값입니다.

getRestClient

public RestClient getRestClient()

REST 클라이언트를 가져옵니다.

반환:

RestClient 개체입니다.

getRestRetryStrategy

public RetryStrategy getRestRetryStrategy()

Rest 재시도 전략을 가져옵니다.

반환:

사용 중인 RetryStrategy.

getUserAgent

public String getUserAgent()

클라이언트의 User-Agent 헤더를 가져옵니다.

반환:

사용자 에이전트 문자열입니다.

initialize

protected void initialize()

생성 후 개체를 초기화합니다.

setAcceptLanguage

public void setAcceptLanguage(String withAcceptLanguage)

응답에 대한 기본 설정 언어를 설정합니다.

매개 변수:

withAcceptLanguage - acceptLanguage 값입니다.

setGenerateClientRequestId

public void setGenerateClientRequestId(boolean requestId)

true로 설정하면 고유한 x-ms-client-request-id 값이 생성되고 각 요청에 포함됩니다.

매개 변수:

requestId - generateClientRequestId 값입니다.

setLongRunningOperationRetryTimeout

public void setLongRunningOperationRetryTimeout(int timeout)

장기 실행 작업의 재시도 시간 제한을 초 단위로 설정합니다. 기본값은 30입니다.

매개 변수:

timeout - longRunningOperationRetryTimeout 값입니다.

setRestRetryStrategy

public void setRestRetryStrategy(RetryStrategy strategy)

Rest 재시도 전략을 설정합니다.

매개 변수:

strategy - 사용할 RetryStrategy.

userAgent

public String userAgent()

AzureServiceClient 버전을 재정의하는 것입니다.

재정의:

RestConnectorClient.userAgent()

반환:

사용자 에이전트입니다. getUserAgent() 동일

적용 대상