IHttpHelper

public interface IHttpHelper

com.android.tradefed.util.net.IHttpHelper

알려진 간접 하위 클래스 HttpHelper HttpHelper HTTP 요청을 위한 도우미 메서드를 포함합니다.

---

HTTP 요청을 실행하기 위한 도우미 메서드입니다.

요약

중첩된 클래스
class	IHttpHelper.DataSizeException

상수
int	MAX_DATA_SIZE

공개 메서드
abstract String	buildParameters(MultiMap<String, String> paramMap) 인코딩된 매개변수 문자열을 빌드합니다.
abstract String	buildUrl(String url, MultiMap<String, String> paramMap) 전체 인코딩된 URL 요청 문자열을 빌드합니다.
abstract HttpURLConnection	createConnection(URL url, String method, String contentType) 지정된 URL을 만듭니다.
abstract HttpURLConnection	createJsonConnection(URL url, String method) JSON 데이터를 전달하기 위해 지정된 URL에 대한 연결을 만듭니다.
abstract HttpURLConnection	createXmlConnection(URL url, String method) xml 데이터를 전달하기 위해 지정된 URL에 대한 연결을 만듭니다.
abstract void	doGet(String url, OutputStream outputStream) 지정된 URL에 대해 GET HTTP 요청 메서드를 실행하고 결과를 ERROR(/OutputStream)로 스트리밍합니다.
abstract String	doGet(String url) 지정된 URL에 대해 GET HTTP 요청 메서드를 실행하고 String로 반환합니다.
abstract void	doGetIgnore(String url) 지정된 URL 매개변수를 사용하여 지정된 URL에 대한 GET을 실행하고 결과를 무시합니다.
abstract void	doGetIgnoreWithRetry(String url) 실패 시 {doGetIgnore(String) 재시도합니다.
abstract String	doGetWithRetry(String url) 실패 시 {doGet(String) 재시도합니다.
abstract String	doPostWithRetry(String url, String postData) 지정된 URL에 대해 POST HTTP 요청 메서드를 실행하고 String로 반환하며 실패하면 다시 시도합니다.
abstract String	doPostWithRetry(String url, String postData, String contentType) 지정된 URL에 대해 POST HTTP 요청 메서드를 실행하고 String로 반환하며 실패하면 다시 시도합니다.
abstract int	getInitialPollInterval() 초기 폴 간격을 밀리초 단위로 가져옵니다.
abstract int	getMaxPollInterval() 최대 폴링 간격을 밀리초 단위로 가져옵니다.
abstract int	getMaxTime() 요청을 계속 시도하는 최대 시간을 밀리초 단위로 가져옵니다.
abstract int	getOpTimeout() 작업 제한 시간을 밀리초 단위로 가져옵니다.
abstract void	setInitialPollInterval(int time) 초기 폴링 간격을 밀리초 단위로 설정합니다.
abstract void	setMaxPollInterval(int time) 초기 폴링 간격을 밀리초 단위로 설정합니다.
abstract void	setMaxTime(int time) 요청을 계속 시도하는 최대 시간을 밀리초 단위로 설정합니다.
abstract void	setOpTimeout(int time) 작업 제한 시간을 밀리초 단위로 설정합니다.

상수

MAX_DATA_SIZE

public static final int MAX_DATA_SIZE

상수 값: 65536 (0x00010000)

공개 메서드

buildParameters

public abstract String buildParameters (MultiMap<String, String> paramMap)

인코딩된 매개변수 문자열을 빌드합니다.

매개변수
paramMap	MultiMap: URL 매개변수

반환 값
String	인코딩된 매개변수 문자열

생성 값
IllegalArgumentException	매개변수 인코딩 중에 예외가 발생합니다.

buildUrl

public abstract String buildUrl (String url, 
                MultiMap<String, String> paramMap)

전체 인코딩된 URL 요청 문자열을 빌드합니다.

매개변수
url	String: 기본 URL
paramMap	MultiMap: URL 매개변수

반환 값
String	생성된 URL

생성 값
IllegalArgumentException	매개변수 인코딩 중에 예외가 발생합니다.

createConnection

public abstract HttpURLConnection createConnection (URL url, 
                String method, 
                String contentType)

지정된 URL을 만듭니다.

매개변수
url	URL: 연결할 ERROR(/URL)입니다.
method	String: HTTP 요청 메서드입니다. 예를 들면 GET 또는 POST입니다.
contentType	String: 콘텐츠 유형입니다. 예: 'text/html'

반환 값
HttpURLConnection	HttpURLConnection

생성 값
	IOException이 발생하면

createJsonConnection

public abstract HttpURLConnection createJsonConnection (URL url, 
                String method)

JSON 데이터를 전달하기 위해 지정된 URL에 대한 연결을 만듭니다.

매개변수
url	URL: 연결할 ERROR(/URL)입니다.
method	String: HTTP 요청 메서드입니다. 예를 들면 GET 또는 POST입니다.

반환 값
HttpURLConnection	ERROR(/HttpURLConnection)

생성 값
	연결에 실패한 경우

createXmlConnection

public abstract HttpURLConnection createXmlConnection (URL url, 
                String method)

xml 데이터를 전달하기 위해 지정된 URL에 대한 연결을 만듭니다.

매개변수
url	URL: 연결할 ERROR(/URL)입니다.
method	String: HTTP 요청 메서드입니다. 예를 들면 GET 또는 POST입니다.

반환 값
HttpURLConnection	ERROR(/HttpURLConnection)

생성 값
	연결에 실패한 경우

doGet

public abstract void doGet (String url, 
                OutputStream outputStream)

지정된 URL에 대해 GET HTTP 요청 메서드를 실행하고 결과를 ERROR(/OutputStream)로 스트리밍합니다.

매개변수
url	String: URL
outputStream	OutputStream: 응답 데이터 스트림

생성 값
	데이터를 가져오지 못한 경우

참고:

• doGet(String)

doGet

public abstract String doGet (String url)

지정된 URL에 대해 GET HTTP 요청 메서드를 실행하고 String로 반환합니다.

원격 콘텐츠는 메모리에 로드되므로 이 메서드는 비교적 작은 데이터 크기에만 사용해야 합니다.

참고 문헌:

• Java URL 연결: http://java.sun.com/docs/books/tutorial/networking/urls/readingWriting.html
• Java URL 리더: http://java.sun.com/docs/books/tutorial/networking/urls/readingURL.html
• Java 프록시 설정: http://java.sun.com/docs/books/tutorial/networking/urls/_setProxy.html

매개변수
url	String: URL

반환 값
String	String 원격 콘텐츠

생성 값
	데이터를 가져오지 못한 경우
IHttpHelper.DataSizeException	가져온 데이터가 MAX_DATA_SIZE보다 큰 경우

doGetIgnore

public abstract void doGetIgnore (String url)

지정된 URL 매개변수를 사용하여 지정된 URL에 대한 GET을 실행하고 결과를 무시합니다.

매개변수
url	String: URL

생성 값
	데이터를 가져오지 못한 경우

참고:

• doGet(String)

doGetIgnoreWithRetry

public abstract void doGetIgnoreWithRetry (String url)

실패 시 {doGetIgnore(String) 재시도합니다.

매개변수
url	String: URL

생성 값
	데이터를 가져오지 못한 경우

참고:

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

doGetWithRetry

public abstract String doGetWithRetry (String url)

실패 시 {doGet(String) 재시도합니다.

매개변수
url	String: URL

반환 값
String	String 원격 콘텐츠

생성 값
	데이터를 가져오지 못한 경우
IHttpHelper.DataSizeException	가져온 데이터가 MAX_DATA_SIZE보다 큰 경우

참고:

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

doPostWithRetry

public abstract String doPostWithRetry (String url, 
                String postData)

지정된 URL에 대해 POST HTTP 요청 메서드를 실행하고 String로 반환하며 실패하면 다시 시도합니다.

원격 콘텐츠는 메모리에 로드되므로 이 메서드는 비교적 작은 데이터 크기에만 사용해야 합니다.

매개변수
url	String: URL
postData	String: 연결이 열리면 게시할 데이터입니다.

반환 값
String	String 원격 콘텐츠

생성 값
	데이터를 가져오지 못한 경우
IHttpHelper.DataSizeException	가져온 데이터가 MAX_DATA_SIZE보다 큰 경우

doPostWithRetry

public abstract String doPostWithRetry (String url, 
                String postData, 
                String contentType)

지정된 URL에 대해 POST HTTP 요청 메서드를 실행하고 String로 반환하며 실패하면 다시 시도합니다.

원격 콘텐츠는 메모리에 로드되므로 이 메서드는 비교적 작은 데이터 크기에만 사용해야 합니다.

매개변수
url	String: URL
postData	String: 연결이 열리면 게시할 데이터입니다.
contentType	String: 콘텐츠 유형입니다. 예: 'text/html'

반환 값
String	String 원격 콘텐츠

생성 값
	데이터를 가져오지 못한 경우
IHttpHelper.DataSizeException	가져온 데이터가 MAX_DATA_SIZE보다 큰 경우

getInitialPollInterval

public abstract int getInitialPollInterval ()

초기 폴 간격을 밀리초 단위로 가져옵니다.

반환 값
int

참고:

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

getMaxPollInterval

public abstract int getMaxPollInterval ()

최대 폴링 간격을 밀리초 단위로 가져옵니다.

반환 값
int

참고:

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

getMaxTime

public abstract int getMaxTime ()

요청을 계속 시도하는 최대 시간을 밀리초 단위로 가져옵니다.

반환 값
int

참고:

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

getOpTimeout

public abstract int getOpTimeout ()

작업 제한 시간을 밀리초 단위로 가져옵니다.

반환 값
int

참고:

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

setInitialPollInterval

public abstract void setInitialPollInterval (int time)

초기 폴링 간격을 밀리초 단위로 설정합니다.

매개변수
time	int

참고:

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

setMaxPollInterval

public abstract void setMaxPollInterval (int time)

초기 폴링 간격을 밀리초 단위로 설정합니다.

매개변수
time	int

참고:

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

setMaxTime

public abstract void setMaxTime (int time)

요청을 계속 시도하는 최대 시간을 밀리초 단위로 설정합니다.

매개변수
time	int

참고:

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)

setOpTimeout

public abstract void setOpTimeout (int time)

작업 제한 시간을 밀리초 단위로 설정합니다.

매개변수
time	int

참고:

• IRunUtil.runEscalatingTimedRetry(long, long, long, long, com.android.tradefed.util.IRunUtil.IRunnableResult)