NetHandle

java.lang.Object
- ohos.net.NetHandle

所有已实现的接口:

Sequenceable
```
public class NetHandle
extends Object
implements Sequenceable
```
Saves the handle of a data network.
You can bind sockets to NetHandle instances to access the Internet.

从以下版本开始:

1

嵌套类概要
- 从接口继承的嵌套类/接口 ohos.utils.Sequenceable
  Sequenceable.Producer<T>

构造器概要

构造器
构造器	说明
`NetHandle()`	ConnectionProperties constructor
`NetHandle(int netId)`	ConnectionProperties constructor
`NetHandle(int netId, boolean privateDnsBypass)`	ConnectionProperties constructor

方法概要

所有方法实例方法具体方法
限定符和类型	方法	说明
`void`	`bindSocket(FileDescriptor fd)`	Binds a `fd` to the current network.
`void`	`bindSocket(DatagramSocket socket)`	Binds a `socket` to the current network.
`void`	`bindSocket(Socket socket)`	Binds a `Socket` to the current network.
`boolean`	`equals(Object obj)`	Indicates whether some other object is "equal to" this one.
`InetAddress[]`	`getAllByName(String host)`	Resolves a host name to obtain all IP addresses.
`InetAddress`	`getByName(String host)`	Resolves a host name to obtain the first IP address.
`long`	`getNetHandle()`	Obtains the ID of a network handle
`SocketFactory`	`getSocketFactory()`	Obtains the `SocketFactory` bound to this `NetHandle`.
`int`	`hashCode()`	Returns a hash code value for the object.
`boolean`	`marshalling(Parcel out)`	Marshals this `Sequenceable` object into a `Parcel`.
`URLConnection`	`openConnection(URL url)`	Accesses a specified URL.
`URLConnection`	`openConnection(URL url, Proxy proxy)`	Accesses a URL by using a specified proxy.
`String`	`toString()`	Composes all the members and their values in the class into a string in sequence.
`boolean`	`unmarshalling(Parcel in)`	Unmarshals this `Sequenceable` object from a `Parcel`.

从类继承的方法 java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

从接口继承的方法 ohos.utils.Sequenceable
hasFileDescriptor

- 构造器详细资料
  - NetHandle
```
public NetHandle(int netId,
                 boolean privateDnsBypass)
```
    ConnectionProperties constructor
    
    参数:
    
    netId - netId of new instance
    
    privateDnsBypass - private dns by pass
    
    从以下版本开始:
    
    1
  - NetHandle
```
public NetHandle(int netId)
```
    ConnectionProperties constructor
    
    参数:
    
    netId - netId of new instance
    
    从以下版本开始:
    
    1
  - NetHandle
```
public NetHandle()
```
    ConnectionProperties constructor
    
    从以下版本开始:
    
    1
- 方法详细资料
  - getAllByName
```
public InetAddress[] getAllByName(String host)
                           throws UnknownHostException
```
    Resolves a host name to obtain all IP addresses.
    
    参数:
    
    host - Indicates the host name.
    
    返回:
    
    Returns the InetAddress list.
    
    抛出:
    
    UnknownHostException - if the address lookup fails.
    
    从以下版本开始:
    
    1
  - getByName
```
public InetAddress getByName(String host)
                      throws UnknownHostException
```
    Resolves a host name to obtain the first IP address.
    
    参数:
    
    host - Indicates the host name.
    
    返回:
    
    Returns the first InetAddress.
    
    抛出:
    
    UnknownHostException - if the address lookup fails.
    
    从以下版本开始:
    
    1
  - bindSocket
```
public void bindSocket(DatagramSocket socket)
                throws IOException
```
    Binds a socket to the current network. All data flows from the socket will use this network, without being subject to NetManager.setAppNet(ohos.net.NetHandle). Before using this method, ensure that the socket is disconnected.
    
    参数:
    
    socket - Indicates the DatagramSocket object.
    
    抛出:
    
    IOException - parse DatagramSocket content error.
    
    从以下版本开始:
    
    1
  - bindSocket
```
public void bindSocket(Socket socket)
                throws IOException
```
    Binds a Socket to the current network. All data flows from the socket will use this network, without being subject to NetManager.setAppNet(ohos.net.NetHandle). Before using this method, ensure that the socket is disconnected.
    
    参数:
    
    socket - Indicates the Socket object.
    
    抛出:
    
    IOException - parse socket error.
    
    从以下版本开始:
    
    1
  - bindSocket
```
public void bindSocket(FileDescriptor fd)
                throws IOException
```
    Binds a fd to the current network. All data flows from the socket will use this network, without being subject to NetManager.setAppNet(ohos.net.NetHandle). Before using this method, ensure that the socket is disconnected.
    
    参数:
    
    fd - Indicates the FileDescriptor object.
    
    抛出:
    
    IOException - parse fd content error.
    
    从以下版本开始:
    
    1
  - getSocketFactory
```
public SocketFactory getSocketFactory()
```
    Obtains the SocketFactory bound to this NetHandle.
    The obtained SocketFactory can be used to create Socket objects that send data through this NetHandle. If the NetHandle is disconnected, the SocketFactory and the created Socket objects will be unavailable.
    
    返回:
    
    Returns the SocketFactory bound to this NetHandle.
    
    从以下版本开始:
    
    5
  - openConnection
```
public URLConnection openConnection(URL url)
                             throws IOException
```
    Accesses a specified URL.
    
    参数:
    
    url - Indicates a URL connection.
    
    返回:
    
    Returns a URLConnection object matching the given url.
    
    抛出:
    
    IllegalArgumentException - if the argument url is null.
    
    IOException - if an error occurs while opening the connection.
    
    从以下版本开始:
    
    1
  - openConnection
```
public URLConnection openConnection(URL url,
                                    Proxy proxy)
                             throws IOException
```
    Accesses a URL by using a specified proxy.
    
    参数:
    
    url - Indicates a URL connection.
    
    proxy - Indicates the proxy.
    
    返回:
    
    Returns a URLConnection object matching the given url.
    
    抛出:
    
    IllegalArgumentException - if the argument url or proxy is null.
    
    IOException - if an error occurs while opening the connection.
    
    从以下版本开始:
    
    1
  - getNetHandle
```
public long getNetHandle()
```
    Obtains the ID of a network handle
    
    返回:
    
    Returns the ID of the network handle.
    
    从以下版本开始:
    
    2
  - equals
```
public boolean equals(Object obj)
```
    从类复制的说明: Object
    Indicates whether some other object is "equal to" this one.
    The equals method implements an equivalence relation on non-null object references:
    - It is reflexive: for any non-null reference value x, x.equals(x) should return true.
    - It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
    - It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
    - It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
    - For any non-null reference value x, x.equals(null) should return false.
    The equals method for class Object implements the most discriminating possible equivalence relation on objects; that is, for any non-null reference values x and y, this method returns true if and only if x and y refer to the same object (x == y has the value true).
    Note that it is generally necessary to override the hashCode method whenever this method is overridden, so as to maintain the general contract for the hashCode method, which states that equal objects must have equal hash codes.
    覆盖:
    
    equals 在类中 Object
    
    参数:
    
    obj - the reference object with which to compare.
    
    返回:
    
    true if this object is the same as the obj argument; false otherwise.
    
    另请参阅:
    
    Object.hashCode(), HashMap
  - hashCode
```
public int hashCode()
```
    从类复制的说明: Object
    Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by HashMap.
    The general contract of hashCode is:
    - Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
    - If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
    - It is not required that if two objects are unequal according to the Object.equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.
    As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (This is typically implemented by converting the internal address of the object into an integer, but this implementation technique is not required by the Java™ programming language.)
    覆盖:
    
    hashCode 在类中 Object
    
    返回:
    
    a hash code value for this object.
    
    另请参阅:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - unmarshalling
```
public boolean unmarshalling(Parcel in)
```
    从接口复制的说明: Sequenceable
    
    Unmarshals this Sequenceable object from a Parcel.
    
    指定者:
    
    unmarshalling 在接口中 Sequenceable
    
    参数:
    
    in - Indicates the Parcel object into which the Sequenceable object has been marshaled.
    
    返回:
    
    Returns true if the unmarshalling is successful; returns false otherwise.
  - marshalling
```
public boolean marshalling(Parcel out)
```
    从接口复制的说明: Sequenceable
    
    Marshals this Sequenceable object into a Parcel.
    
    指定者:
    
    marshalling 在接口中 Sequenceable
    
    参数:
    
    out - Indicates the Parcel object to which the Sequenceable object will be marshaled..
    
    返回:
    
    Returns true if the marshalling is successful; returns false otherwise.
  - toString
```
public String toString()
```
    Composes all the members and their values in the class into a string in sequence.
    
    覆盖:
    
    toString 在类中 Object
    
    返回:
    
    Returns a string that is composed of all the members and their values in the class.
    
    从以下版本开始:
    
    5

类 NetHandle

嵌套类概要

从接口继承的嵌套类/接口 ohos.utils.Sequenceable

构造器概要

方法概要

从类继承的方法 java.lang.Object

从接口继承的方法 ohos.utils.Sequenceable

构造器详细资料

NetHandle

NetHandle

NetHandle

方法详细资料

getAllByName

getByName

bindSocket

bindSocket

bindSocket

getSocketFactory

openConnection

openConnection

getNetHandle

equals

hashCode

unmarshalling

marshalling

toString