URLConnection Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
La clase URLConnection
abstracta es la superclase de todas las clases que representan un vínculo de comunicaciones entre la aplicación y una dirección URL.
[Android.Runtime.Register("java/net/URLConnection", DoNotGenerateAcw=true)]
public abstract class URLConnection : Java.Lang.Object
[<Android.Runtime.Register("java/net/URLConnection", DoNotGenerateAcw=true)>]
type URLConnection = class
inherit Object
- Herencia
- Derivado
- Atributos
Comentarios
La clase URLConnection
abstracta es la superclase de todas las clases que representan un vínculo de comunicaciones entre la aplicación y una dirección URL. Las instancias de esta clase se pueden usar tanto para leer desde como para escribir en el recurso al que hace referencia la dirección URL. En general, la creación de una conexión a una dirección URL es un proceso de varios pasos:
<center><table border=2 summary="Describe el proceso de creación de una conexión a una dirección URL: openConnection() y connect() a lo largo del tiempo".><tr><th/thopenConnection()
<><>/th><><connect()
/tr tr td<><>>Parameters that affect the connection to the remote resource.</td td><>Interact con el recurso; los campos y el contenido del encabezado de consulta.</td></tr></table> ----------------------------> <br>time</center>
<ol><li>El objeto de conexión se crea invocando el openConnection
método en una dirección URL. <li>Los parámetros de instalación y las propiedades generales de la solicitud se manipulan. <li>La conexión real al objeto remoto se realiza mediante el connect
método . <li>El objeto remoto está disponible. Se puede acceder a los campos de encabezado y al contenido del objeto remoto. </Ol>
Los parámetros de instalación se modifican mediante los métodos siguientes: <ul><li>setAllowUserInteraction
<li>setDoInput
<li><setDoOutput
lisetIfModifiedSince
<><>setUseCaches
/ul>
y las propiedades generales de solicitud se modifican mediante el método : <ul><li>setRequestProperty
</ul>
Los valores predeterminados de los AllowUserInteraction
parámetros y UseCaches
se pueden establecer mediante los métodos setDefaultAllowUserInteraction
y setDefaultUseCaches
.
Cada uno de los métodos anteriores set
tiene un método correspondiente get
para recuperar el valor del parámetro o la propiedad de solicitud general. Los parámetros específicos y las propiedades de solicitud generales que son aplicables son específicos del protocolo.
Los métodos siguientes se usan para tener acceso a los campos de encabezado y al contenido después de realizar la conexión al objeto remoto: ul>li li>><getHeaderField
getContent
<li ligetOutputStream
<getInputStream
>></ul<<>
Se accede a determinados campos de encabezado con frecuencia. Los métodos: <ul><li<>getContentEncoding
li>getContentLength
<li>getContentType
<ligetDate
<>li ligetExpiration
<><>getLastModifed
/ul>
proporcionar un acceso cómodo a estos campos. El getContentType
método utiliza el getContent
método para determinar el tipo del objeto remoto; las subclases pueden resultar convenientes para invalidar el getContentType
método.
En el caso común, se pueden omitir todos los parámetros de conexión previos y las propiedades de solicitud generales: los parámetros de conexión previa y las propiedades de solicitud predeterminadas a valores razonables. Para la mayoría de los clientes de esta interfaz, solo hay dos métodos interesantes: getInputStream
y getContent
, que se reflejan en la URL
clase por métodos de conveniencia.
Puede encontrar más información sobre las propiedades de solicitud y los campos de encabezado de una http
conexión en: <blockquote>
<a href="http://www.ietf.org/rfc/rfc2616.txt">http://www.ietf.org/rfc/rfc2616.txt</a>
</blockquote>
Invocar los close()
métodos en InputStream
o OutputStream
después de URLConnection
una solicitud puede liberar recursos de red asociados a esta instancia, a menos que determinadas especificaciones de protocolo especifiquen comportamientos diferentes para ella.
Agregado en JDK1.0.
Documentación de Java para java.net.URLConnection
.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.
Constructores
URLConnection(IntPtr, JniHandleOwnership) |
Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución. |
URLConnection(URL) |
Construye una conexión url a la dirección URL especificada. |
Propiedades
AllowUserInteraction |
Devuelve el valor del |
Class |
Devuelve la clase en tiempo de ejecución de este |
Connected |
Si |
ConnectTimeout |
Devuelve la configuración del tiempo de espera de conexión. -o bien- Establece un valor de tiempo de espera especificado, en milisegundos, que se usará al abrir un vínculo de comunicaciones al recurso al que hace referencia esta dirección URLConnection. |
Content |
Recupera el contenido de esta conexión url. |
ContentEncoding |
Devuelve el valor del |
ContentLength |
Devuelve el valor del |
ContentLengthLong |
Devuelve el valor del |
ContentType |
Devuelve el valor del |
Date |
Devuelve el valor del |
DefaultAllowUserInteraction |
Devuelve el valor predeterminado del |
DefaultUseCaches |
Devuelve el valor predeterminado de una marca de |
DoInput |
Devuelve el valor de esta |
DoOutput |
Devuelve el valor de esta |
Expiration |
Devuelve el valor del |
FileNameMap |
Devuelve una |
Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
HeaderFields |
Devuelve un mapa no modificable de los campos de encabezado. |
IfModifiedSince |
Devuelve el valor del campo de |
InputStream |
Devuelve un flujo de entrada que lee de esta conexión abierta. |
JniIdentityHashCode |
La clase |
JniPeerMembers |
La clase |
LastModified |
Devuelve el valor del |
OutputStream |
Devuelve un flujo de salida que escribe en esta conexión. |
PeerReference |
La clase |
Permission |
Devuelve un objeto de permiso que representa el permiso necesario para realizar la conexión representada por este objeto. |
ReadTimeout |
Devuelve la configuración del tiempo de espera de lectura. -o bien- Establece el tiempo de espera de lectura en un tiempo de espera especificado, en milisegundos. |
RequestProperties |
Devuelve un mapa no modificable de las propiedades de solicitud generales para esta conexión. |
ThresholdClass |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
ThresholdType |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
Url |
La dirección URL representa el objeto remoto en la World Wide Web a la que se abre esta conexión. |
URL |
Devuelve el valor de |
UseCaches |
Devuelve el valor de |
Métodos
AddRequestProperty(String, String) |
Agrega una propiedad de solicitud general especificada por un par clave-valor. |
Clone() |
Crea y devuelve una copia de este objeto. (Heredado de Object) |
Connect() |
Abre un vínculo de comunicaciones al recurso al que hace referencia esta dirección URL, si aún no se ha establecido dicha conexión. |
ConnectAsync() |
La clase |
Dispose() |
La clase |
Dispose(Boolean) |
La clase |
Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
GetContent(Class[]) |
Recupera el contenido de esta conexión url. |
GetDefaultRequestProperty(String) |
Obsoletos.
Devuelve el valor de la propiedad de solicitud predeterminada. |
GetHashCode() |
Devuelve un valor de código hash del objeto. (Heredado de Object) |
GetHeaderField(Int32) |
Devuelve el valor del |
GetHeaderField(String) |
Devuelve el valor del campo de encabezado con nombre. |
GetHeaderFieldDate(String, Int64) |
Devuelve el valor del campo con nombre analizado como fecha. |
GetHeaderFieldInt(String, Int32) |
Devuelve el valor del campo con nombre analizado como un número. |
GetHeaderFieldKey(Int32) |
Devuelve la clave del |
GetHeaderFieldLong(String, Int64) |
Devuelve el valor del campo con nombre analizado como un número. |
GetRequestProperty(String) |
Devuelve el valor de la propiedad de solicitud general con nombre para esta conexión. |
GuessContentTypeFromName(String) |
Intenta determinar el tipo de contenido de un objeto, en función del componente "file" especificado de una dirección URL. |
GuessContentTypeFromStream(Stream) |
Intenta determinar el tipo de una secuencia de entrada en función de los caracteres al principio del flujo de entrada. |
JavaFinalize() |
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
SetContentHandlerFactory(IContentHandlerFactory) |
Establece el |
SetDefaultRequestProperty(String, String) |
Obsoletos.
Establece el valor predeterminado de una propiedad de solicitud general. |
SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
SetRequestProperty(String, String) |
Establece la propiedad de solicitud general. |
ToArray<T>() |
La clase |
ToString() |
Devuelve una representación de cadena del objeto. (Heredado de Object) |
UnregisterFromRuntime() |
La clase |
Wait() |
Hace que el subproceso actual espere hasta que se despierta, normalmente por ser em notificado/em> o <em>interrumpido</em>.<>< (Heredado de Object) |
Wait(Int64) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
Implementaciones de interfaz explícitas
IJavaPeerable.Disposed() |
La clase |
IJavaPeerable.DisposeUnlessReferenced() |
La clase |
IJavaPeerable.Finalized() |
La clase |
IJavaPeerable.JniManagedPeerState |
La clase |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
La clase |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
La clase |
IJavaPeerable.SetPeerReference(JniObjectReference) |
La clase |
Métodos de extensión
JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
JavaCast<TResult>(IJavaObject) |
La clase |
GetJniTypeName(IJavaPeerable) |
La clase |