IHttpHelper

public interface IHttpHelper

com.android.tradefed.util.net.IHttpHelper

คลาสย่อยโดยอ้อมที่รู้จัก HttpHelper HttpHelper มีวิธีช่วยในการสร้างคำขอ HTTP

---

เมธอด Helper สำหรับการส่งคำขอ 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) สร้างการเชื่อมต่อกับ URL ที่ระบุเพื่อส่งข้อมูล JSON
abstract HttpURLConnection	createXmlConnection(URL url, String method) สร้างการเชื่อมต่อกับ URL ที่ระบุเพื่อส่งข้อมูล XML
abstract void	doGet(String url, OutputStream outputStream) สร้างเมธอดคำขอ GET HTTP สำหรับ URL หนึ่งๆ และสตรีมผลลัพธ์ไปยัง ERROR(/OutputStream)
abstract String	doGet(String url) สร้างเมธอดคำขอ GET HTTP สำหรับ URL หนึ่งๆ และแสดงผลเป็น String
abstract void	doGetIgnore(String url) ดำเนินการ GET สำหรับ URL ที่ระบุ โดยมีพารามิเตอร์ของ URL ที่ระบุละเว้นผลลัพธ์
abstract void	doGetIgnoreWithRetry(String url) ดำเนินการ {doGetIgnore(String) ลองใหม่เมื่อล้มเหลว
abstract String	doGetWithRetry(String url) ดำเนินการ {doGet(String) ลองใหม่เมื่อล้มเหลว
abstract String	doPostWithRetry(String url, String postData) สร้างเมธอดคำขอ HTTP แบบ POST สำหรับ URL หนึ่งๆ และแสดงผลเป็น String กำลังลองใหม่เมื่อล้มเหลว
abstract String	doPostWithRetry(String url, String postData, String contentType) สร้างเมธอดคำขอ HTTP แบบ POST สำหรับ URL หนึ่งๆ และแสดงผลเป็น 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) กำหนดระยะหมดเวลาของการดำเนินการเป็นมิลลิวินาที

ค่าคงที่

ขนาดข้อมูลสูงสุด

public static final int MAX_DATA_SIZE

มูลค่าคงที่: 65,536 (0x00010000)

วิธีการสาธารณะ

พารามิเตอร์บิลด์

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	หากมีข้อยกเว้นเกิดขึ้นให้เข้ารหัสพารามิเตอร์

สร้างการเชื่อมต่อ

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)

สร้างการเชื่อมต่อกับ URL ที่ระบุเพื่อส่งข้อมูล JSON

พารามิเตอร์
url	URL: ERROR(/URL) ที่จะเชื่อมต่อ
method	String: เมธอดคำขอ HTTP เช่น GET หรือ POST

คิกรีเทิร์น
HttpURLConnection	ERROR(/HttpURLConnection)

การขว้าง
	หากเชื่อมต่อไม่สำเร็จ

createXmlConnection

public abstract HttpURLConnection createXmlConnection (URL url, 
                String method)

สร้างการเชื่อมต่อกับ URL ที่ระบุเพื่อส่งข้อมูล XML

พารามิเตอร์
url	URL: ERROR(/URL) ที่จะเชื่อมต่อ
method	String: เมธอดคำขอ HTTP เช่น GET หรือ POST

คิกรีเทิร์น
HttpURLConnection	ERROR(/HttpURLConnection)

การขว้าง
	หากเชื่อมต่อไม่สำเร็จ

DoGet

public abstract void doGet (String url, 
                OutputStream outputStream)

สร้างเมธอดคำขอ GET HTTP สำหรับ URL หนึ่งๆ และสตรีมผลลัพธ์ไปยัง ERROR(/OutputStream)

พารามิเตอร์
url	String: URL
outputStream	OutputStream: สตรีมข้อมูลคำตอบ

การขว้าง
	หากดึงข้อมูลไม่สำเร็จ

ดูเพิ่มเติม

• doGet(String)

DoGet

public abstract String doGet (String url)

สร้างเมธอดคำขอ GET HTTP สำหรับ URL หนึ่งๆ และแสดงผลเป็น String

เนื่องจากเนื้อหาระยะไกลจะโหลดลงในหน่วยความจำ วิธีนี้จึงควรใช้สำหรับ ขนาดข้อมูลที่ค่อนข้างเล็ก

ข้อมูลอ้างอิง:

• การเชื่อมต่อ Java URL: http://java.sun.com/docs/books/tutorial/networking/urls/readingWriting.html
• โปรแกรมอ่าน URL ของ Java: 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

ไม่สนใจ

public abstract void doGetIgnore (String url)

ดำเนินการ GET สำหรับ URL ที่ระบุ โดยมีพารามิเตอร์ของ URL ที่ระบุละเว้นผลลัพธ์

พารามิเตอร์
url	String: URL

การขว้าง
	หากดึงข้อมูลไม่สำเร็จ

ดูเพิ่มเติม

• doGet(String)

ทำไม่สนใจด้วยการลองใหม่

public abstract void doGetIgnoreWithRetry (String url)

ดำเนินการ {doGetIgnore(String) ลองใหม่เมื่อล้มเหลว

พารามิเตอร์
url	String: URL

การขว้าง
	หากดึงข้อมูลไม่สำเร็จ

ดูเพิ่มเติม

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

ทำด้วยลองใหม่

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)

โพสต์ด้วยการลองใหม่

public abstract String doPostWithRetry (String url, 
                String postData)

สร้างเมธอดคำขอ HTTP แบบ POST สำหรับ URL หนึ่งๆ และแสดงผลเป็น String กำลังลองใหม่เมื่อล้มเหลว

เนื่องจากเนื้อหาระยะไกลจะโหลดลงในหน่วยความจำ วิธีนี้จึงควรใช้สำหรับ ขนาดข้อมูลที่ค่อนข้างเล็ก

พารามิเตอร์
url	String: URL
postData	String: ข้อมูลที่จะโพสต์เมื่อการเชื่อมต่อเปิด

คิกรีเทิร์น
String	เนื้อหาระยะไกลของ String

การขว้าง
	หากดึงข้อมูลไม่สำเร็จ
IHttpHelper.DataSizeException	หากข้อมูลที่ดึงมาคือ > MAX_DATA_SIZE

โพสต์ด้วยการลองใหม่

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

สร้างเมธอดคำขอ HTTP แบบ POST สำหรับ URL หนึ่งๆ และแสดงผลเป็น String กำลังลองใหม่เมื่อล้มเหลว

เนื่องจากเนื้อหาระยะไกลจะโหลดลงในหน่วยความจำ วิธีนี้จึงควรใช้สำหรับ ขนาดข้อมูลที่ค่อนข้างเล็ก

พารามิเตอร์
url	String: URL
postData	String: ข้อมูลที่จะโพสต์เมื่อการเชื่อมต่อเปิด
contentType	String: ประเภทเนื้อหา เช่น "text/html"

คิกรีเทิร์น
String	เนื้อหาระยะไกลของ String

การขว้าง
	หากดึงข้อมูลไม่สำเร็จ
IHttpHelper.DataSizeException	หากข้อมูลที่ดึงมาคือ > MAX_DATA_SIZE

ช่วงการสำรวจเริ่มต้น

public abstract int getInitialPollInterval ()

ดูช่วงเวลาของแบบสำรวจเริ่มต้นในหน่วยมิลลิวินาที

คิกรีเทิร์น
int

ดูเพิ่มเติม

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

ช่วงการสำรวจความคิดเห็นสูงสุด

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)

getOpระยะหมดเวลา

public abstract int getOpTimeout ()

ดูระยะหมดเวลาของการดำเนินการในหน่วยมิลลิวินาที

คิกรีเทิร์น
int

ดูเพิ่มเติม

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

ตั้งค่าช่วงการสำรวจครั้งแรก

public abstract void setInitialPollInterval (int time)

กำหนดช่วงเวลาของการสำรวจความคิดเห็นเริ่มต้นเป็นมิลลิวินาที

พารามิเตอร์
time	int

ดูเพิ่มเติม

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

ตั้งค่าMaxPollInterval

public abstract void setMaxPollInterval (int time)

กำหนดช่วงเวลาของการสำรวจความคิดเห็นเริ่มต้นเป็นมิลลิวินาที

พารามิเตอร์
time	int

ดูเพิ่มเติม

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

ตั้งค่าเวลาสูงสุด

public abstract void setMaxTime (int time)

ตั้งเวลาสูงสุดเพื่อลองส่งคำขอต่อไปเป็นมิลลิวินาที

พารามิเตอร์
time	int

ดูเพิ่มเติม

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

setOpระยะหมดเวลา

public abstract void setOpTimeout (int time)

กำหนดระยะหมดเวลาของการดำเนินการเป็นมิลลิวินาที

พารามิเตอร์
time	int

ดูเพิ่มเติม

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