http request
1.0.0
Una biblioteca sencilla y práctica para utilizar HttpURLConnection para realizar solicitudes y acceder a la respuesta.
Esta biblioteca está disponible bajo la licencia MIT.
La biblioteca de solicitudes http está disponible en Maven Central.
< dependency >
< groupId >com.github.kevinsawicki</ groupId >
< artifactId >http-request</ artifactId >
< version >6.0</ version >
</ dependency >¿No utilizas Maven? Simplemente copie la clase HttpRequest en su proyecto, actualice la declaración del paquete y estará listo.
Los Javadocs están disponibles aquí.
Consulte aquí para obtener una lista de proyectos conocidos que utilizan esta biblioteca.
Esta biblioteca fue escrita para hacer que las solicitudes HTTP sean simples y fáciles cuando se usa HttpURLConnection .
Las bibliotecas como Apache HttpComponents son excelentes, pero a veces, ya sea por simplicidad o quizás por el entorno en el que está implementando (Android), solo desea usar una buena y antigua HttpURLConnection . Esta biblioteca busca agregar conveniencia y patrones comunes al acto de realizar solicitudes HTTP, como una interfaz fluida para generar solicitudes y soporte para funciones como solicitudes de varias partes.
En pocas palabras: el único objetivo de esta biblioteca es mejorar la usabilidad de la clase HttpURLConnection .
Ninguno . El objetivo de esta biblioteca es ser una clase única con algunas clases estáticas internas. El proyecto de prueba requiere Jetty para probar las solicitudes con una implementación de servidor HTTP real.
La clase HttpRequest no genera ninguna excepción marcada; en cambio, todas las excepciones de bajo nivel están envueltas en una HttpRequestException que extiende RuntimeException . Puede acceder a la excepción subyacente detectando HttpRequestException y llamando getCause() que siempre devolverá la IOException original.
No . El objeto HttpUrlConnection subyacente que envuelve cada objeto HttpRequest tiene una API sincrónica y, por lo tanto, todos los métodos de HttpRequest también son sincrónicos.
Por lo tanto, es importante no utilizar un objeto HttpRequest en el hilo principal de su aplicación.
Aquí hay un ejemplo simple de Android sobre su uso desde AsyncTask:
private class DownloadTask extends AsyncTask < String , Long , File > {
protected File doInBackground ( String ... urls ) {
try {
HttpRequest request = HttpRequest . get ( urls [ 0 ]);
File file = null ;
if ( request . ok ()) {
file = File . createTempFile ( "download" , ".tmp" );
request . receive ( file );
publishProgress ( file . length ());
}
return file ;
} catch ( HttpRequestException exception ) {
return null ;
}
}
protected void onProgressUpdate ( Long ... progress ) {
Log . d ( "MyApp" , "Downloaded bytes: " + progress [ 0 ]);
}
protected void onPostExecute ( File file ) {
if ( file != null )
Log . d ( "MyApp" , "Downloaded file to: " + file . getAbsolutePath ());
else
Log . d ( "MyApp" , "Download failed" );
}
}
new DownloadTask (). execute ( "http://google.com" ); int response = HttpRequest . get ( "http://google.com" ). code (); String response = HttpRequest . get ( "http://google.com" ). body ();
System . out . println ( "Response was: " + response ); HttpRequest . get ( "http://google.com" ). receive ( System . out ); HttpRequest request = HttpRequest . get ( "http://google.com" , true , 'q' , "baseball gloves" , "size" , 100 );
System . out . println ( request . toString ()); // GET http://google.com?q=baseball%20gloves&size=100 int [] ids = new int [] { 22 , 23 };
HttpRequest request = HttpRequest . get ( "http://google.com" , true , "id" , ids );
System . out . println ( request . toString ()); // GET http://google.com?id[]=22&id[]=23 String contentType = HttpRequest . get ( "http://google.com" )
. accept ( "application/json" ) //Sets request header
. contentType (); //Gets response header
System . out . println ( "Response content type was " + contentType ); int response = HttpRequest . post ( "http://google.com" ). send ( "name=kevin" ). code (); int response = HttpRequest . get ( "http://google.com" ). basic ( "username" , "p4ssw0rd" ). code (); HttpRequest request = HttpRequest . post ( "http://google.com" );
request . part ( "status[body]" , "Making a multipart request" );
request . part ( "status[image]" , new File ( "/home/kevin/Pictures/ide.png" ));
if ( request . ok ())
System . out . println ( "Status was updated" ); Map < String , String > data = new HashMap < String , String >();
data . put ( "user" , "A User" );
data . put ( "state" , "CA" );
if ( HttpRequest . post ( "http://google.com" ). form ( data ). created ())
System . out . println ( "User was created" ); File output = new File ( "/output/request.out" );
HttpRequest . get ( "http://google.com" ). receive ( output ); File input = new File ( "/input/data.txt" );
int response = HttpRequest . post ( "http://google.com" ). send ( input ). code (); File latest = new File ( "/data/cache.json" );
HttpRequest request = HttpRequest . get ( "http://google.com" );
//Copy response to file
request . receive ( latest );
//Store eTag of response
String eTag = request . eTag ();
//Later on check if changes exist
boolean unchanged = HttpRequest . get ( "http://google.com" )
. ifNoneMatch ( eTag )
. notModified (); HttpRequest request = HttpRequest . get ( "http://google.com" );
//Tell server to gzip response and automatically uncompress
request . acceptGzipEncoding (). uncompress ( true );
String uncompressed = request . body ();
System . out . println ( "Uncompressed response is: " + uncompressed ); HttpRequest request = HttpRequest . get ( "https://google.com" );
//Accept all certificates
request . trustAllCerts ();
//Accept all hostnames
request . trustAllHosts (); HttpRequest request = HttpRequest . get ( "https://google.com" );
//Configure proxy
request . useProxy ( "localhost" , 8080 );
//Optional proxy basic authentication
request . proxyBasic ( "username" , "p4ssw0rd" ); int code = HttpRequest . get ( "http://google.com" ). followRedirects ( true ). code ();¿Quiere utilizar esta biblioteca con OkHttp? Lea aquí.
HttpRequest . setConnectionFactory ( new ConnectionFactory () {
public HttpURLConnection create ( URL url ) throws IOException {
if (! "https" . equals ( url . getProtocol ()))
throw new IOException ( "Only secure requests are allowed" );
return ( HttpURLConnection ) url . openConnection ();
}
public HttpURLConnection create ( URL url , Proxy proxy ) throws IOException {
if (! "https" . equals ( url . getProtocol ()))
throw new IOException ( "Only secure requests are allowed" );
return ( HttpURLConnection ) url . openConnection ( proxy );
}
});
