Provides a simple HTTP server. [詳解]

公開メンバ関数
	HttpServer ()
	Initializes a new instance of the HttpServer class.

	HttpServer (int port)
	Initializes a new instance of the HttpServer class with the specified port.

	HttpServer (string url)
	Initializes a new instance of the HttpServer class with the specified URL.

	HttpServer (int port, bool secure)
	Initializes a new instance of the HttpServer class with the specified port and boolean if secure or not.

	HttpServer (System.Net.IPAddress address, int port)
	Initializes a new instance of the HttpServer class with the specified IP address and port.

	HttpServer (System.Net.IPAddress address, int port, bool secure)
	Initializes a new instance of the HttpServer class with the specified IP address, port, and boolean if secure or not.

void	AddWebSocketService< TBehavior > (string path)
	Adds a WebSocket service with the specified behavior and path.

void	AddWebSocketService< TBehavior > (string path, Action< TBehavior > initializer)
	Adds a WebSocket service with the specified behavior, path, and initializer.

bool	RemoveWebSocketService (string path)
	Removes a WebSocket service with the specified path.

void	Start ()
	Starts receiving incoming requests.

void	Stop ()
	Stops receiving incoming requests.

プロパティ
System.Net.IPAddress	Address `[get]`
	Gets the IP address of the server.

AuthenticationSchemes	AuthenticationSchemes `[get, set]`
	Gets or sets the scheme used to authenticate the clients.

string	DocumentRootPath `[get, set]`
	Gets or sets the path to the document folder of the server.

bool	IsListening `[get]`
	Gets a value indicating whether the server has started.

bool	IsSecure `[get]`
	Gets a value indicating whether the server provides secure connections.

bool	KeepClean `[get, set]`
	Gets or sets a value indicating whether the server cleans up the inactive sessions periodically.

Logger	Log `[get]`
	Gets the logging function for the server.

int	Port `[get]`
	Gets the port of the server.

string	Realm `[get, set]`
	Gets or sets the name of the realm associated with the server.

bool	ReuseAddress `[get, set]`
	Gets or sets a value indicating whether the server is allowed to be bound to an address that is already in use.

ServerSslConfiguration	SslConfiguration `[get]`
	Gets the configuration for secure connection.

Func< IIdentity, NetworkCredential >	UserCredentialsFinder `[get, set]`
	Gets or sets the delegate called to find the credentials for an identity used to authenticate a client.

TimeSpan	WaitTime `[get, set]`
	Gets or sets the time to wait for the response to the WebSocket Ping or Close.

WebSocketServiceManager	WebSocketServices `[get]`
	Gets the management function for the WebSocket services provided by the server.

イベント
EventHandler< HttpRequestEventArgs >	OnConnect
	Occurs when the server receives an HTTP CONNECT request.

EventHandler< HttpRequestEventArgs >	OnDelete
	Occurs when the server receives an HTTP DELETE request.

EventHandler< HttpRequestEventArgs >	OnGet
	Occurs when the server receives an HTTP GET request.

EventHandler< HttpRequestEventArgs >	OnHead
	Occurs when the server receives an HTTP HEAD request.

EventHandler< HttpRequestEventArgs >	OnOptions
	Occurs when the server receives an HTTP OPTIONS request.

EventHandler< HttpRequestEventArgs >	OnPost
	Occurs when the server receives an HTTP POST request.

EventHandler< HttpRequestEventArgs >	OnPut
	Occurs when the server receives an HTTP PUT request.

EventHandler< HttpRequestEventArgs >	OnTrace
	Occurs when the server receives an HTTP TRACE request.

詳解

Provides a simple HTTP server.

The server supports HTTP/1.1 version request and response.

Also the server allows to accept WebSocket handshake requests.

This class can provide multiple WebSocket services.

構築子と解体子

◆ HttpServer() [1/6]

WebSocketSharp.Server.HttpServer.HttpServer ( )

inline

Initializes a new instance of the HttpServer class.

The new instance listens for incoming requests on System.Net.IPAddress.Any and port 80.

◆ HttpServer() [2/6]

WebSocketSharp.Server.HttpServer.HttpServer ( int port )

inline

Initializes a new instance of the HttpServer class with the specified port.

The new instance listens for incoming requests on System.Net.IPAddress.Any and port .

It provides secure connections if port is 443.

引数

port	An int that specifies the number of the port on which to listen.

例外

ArgumentOutOfRangeException port is less than 1 or greater than 65535.

◆ HttpServer() [3/6]

WebSocketSharp.Server.HttpServer.HttpServer ( string url )

inline

Initializes a new instance of the HttpServer class with the specified URL.

The new instance listens for incoming requests on the IP address and port of url .

Either port 80 or 443 is used if url includes no port. Port 443 is used if the scheme of url is https; otherwise, port 80 is used.

The new instance provides secure connections if the scheme of url is https.

引数

url	A string that specifies the HTTP URL of the server.

例外

ArgumentException	url is an empty string. -or- url is invalid.
ArgumentNullException	url is `null`.

◆ HttpServer() [4/6]

WebSocketSharp.Server.HttpServer.HttpServer	(	int	port,
		bool	secure )

inline

Initializes a new instance of the HttpServer class with the specified port and boolean if secure or not.

The new instance listens for incoming requests on System.Net.IPAddress.Any and port .

引数

port	An int that specifies the number of the port on which to listen.
secure	A bool: `true` if the new instance provides secure connections; otherwise, `false`.

例外

ArgumentOutOfRangeException port is less than 1 or greater than 65535.

◆ HttpServer() [5/6]

WebSocketSharp.Server.HttpServer.HttpServer	(	System.Net.IPAddress	address,
		int	port )

inline

Initializes a new instance of the HttpServer class with the specified IP address and port.

The new instance listens for incoming requests on address and port .

It provides secure connections if port is 443.

引数

address	A System.Net.IPAddress that specifies the local IP address on which to listen.
port	An int that specifies the number of the port on which to listen.

例外

ArgumentException	address is not a local IP address.
ArgumentNullException	address is `null`.
ArgumentOutOfRangeException	port is less than 1 or greater than 65535.

◆ HttpServer() [6/6]

WebSocketSharp.Server.HttpServer.HttpServer	(	System.Net.IPAddress	address,
		int	port,
		bool	secure )

inline

Initializes a new instance of the HttpServer class with the specified IP address, port, and boolean if secure or not.

The new instance listens for incoming requests on address and port .

引数

address	A System.Net.IPAddress that specifies the local IP address on which to listen.
port	An int that specifies the number of the port on which to listen.
secure	A bool: `true` if the new instance provides secure connections; otherwise, `false`.

例外

ArgumentException	address is not a local IP address.
ArgumentNullException	address is `null`.
ArgumentOutOfRangeException	port is less than 1 or greater than 65535.

関数詳解

◆ AddWebSocketService< TBehavior >() [1/2]

void WebSocketSharp.Server.HttpServer.AddWebSocketService< TBehavior > ( string path )

inline

Adds a WebSocket service with the specified behavior and path.

引数

path	A string that specifies an absolute path to the service to add. / is trimmed from the end of the string if present.

テンプレート引数

TBehavior The type of the behavior for the service. It must inherit the WebSocketBehavior class. Also it must have a public parameterless constructor.

例外

ArgumentException	path is an empty string. -or- path is not an absolute path. -or- path includes either or both query and fragment components. -or- path is already in use.
ArgumentNullException	path is `null`.

型制約

TBehavior	:	WebSocketBehavior
TBehavior	:	new

◆ AddWebSocketService< TBehavior >() [2/2]

void WebSocketSharp.Server.HttpServer.AddWebSocketService< TBehavior >	(	string	path,
		Action< TBehavior >	initializer )

inline

Adds a WebSocket service with the specified behavior, path, and initializer.

引数

path	A string that specifies an absolute path to the service to add. / is trimmed from the end of the string if present.
initializer	An T:System.Action<TBehavior> delegate. It specifies the delegate called when the service initializes a new session instance. `null` if not necessary.

テンプレート引数

TBehavior The type of the behavior for the service. It must inherit the WebSocketBehavior class. Also it must have a public parameterless constructor.

例外

ArgumentException	path is an empty string. -or- path is not an absolute path. -or- path includes either or both query and fragment components. -or- path is already in use.
ArgumentNullException	path is `null`.

型制約

TBehavior	:	WebSocketBehavior
TBehavior	:	new

◆ RemoveWebSocketService()

bool WebSocketSharp.Server.HttpServer.RemoveWebSocketService ( string path )

inline

Removes a WebSocket service with the specified path.

The service is stopped with close status 1001 (going away) if the current state of the service is Start.

戻り値: true if the service is successfully found and removed; otherwise, false.

引数

path	A string that specifies an absolute path to the service to remove. / is trimmed from the end of the string if present.

例外

ArgumentException	path is an empty string. -or- path is not an absolute path. -or- path includes either or both query and fragment components.
ArgumentNullException	path is `null`.

◆ Start()

void WebSocketSharp.Server.HttpServer.Start ( )

inline

Starts receiving incoming requests.

This method works if the current state of the server is Ready or Stop.

例外

InvalidOperationException There is no server certificate for secure connection. -or- The underlying HttpListener has failed to start.

◆ Stop()

void WebSocketSharp.Server.HttpServer.Stop ( )

inline

Stops receiving incoming requests.

This method works if the current state of the server is Start.

プロパティ詳解

◆ Address

System.Net.IPAddress WebSocketSharp.Server.HttpServer.Address

get

Gets the IP address of the server.

A System.Net.IPAddress that represents the local IP address on which to listen for incoming requests.

◆ AuthenticationSchemes

AuthenticationSchemes WebSocketSharp.Server.HttpServer.AuthenticationSchemes

getset

Gets or sets the scheme used to authenticate the clients.

The set operation works if the current state of the server is Ready or Stop.

One of the WebSocketSharp.Net.AuthenticationSchemes enum values.

It represents the scheme used to authenticate the clients.

The default value is WebSocketSharp.Net.AuthenticationSchemes.Anonymous.

◆ DocumentRootPath

string WebSocketSharp.Server.HttpServer.DocumentRootPath

getset

Gets or sets the path to the document folder of the server.

The set operation works if the current state of the server is Ready or Stop.

A string that represents a path to the folder from which to find the requested file.

/ or \ is trimmed from the end of the value if present.

The default value is "./Public".

例外

ArgumentException	The value specified for a set operation is an empty string. -or- The value specified for a set operation is an absolute root. -or- The value specified for a set operation is an invalid path string.
ArgumentNullException	The value specified for a set operation is `null`.

◆ IsListening

bool WebSocketSharp.Server.HttpServer.IsListening

get

Gets a value indicating whether the server has started.

true if the server has started; otherwise, false.

◆ IsSecure

bool WebSocketSharp.Server.HttpServer.IsSecure

get

Gets a value indicating whether the server provides secure connections.

true if the server provides secure connections; otherwise, false.

◆ KeepClean

bool WebSocketSharp.Server.HttpServer.KeepClean

getset

Gets or sets a value indicating whether the server cleans up the inactive sessions periodically.

The set operation works if the current state of the server is Ready or Stop.

true if the server cleans up the inactive sessions every 60 seconds; otherwise, false.

The default value is false.

◆ Log

Logger WebSocketSharp.Server.HttpServer.Log

get

Gets the logging function for the server.

The default logging level is LogLevel.Error.

A Logger that provides the logging function.

◆ Port

int WebSocketSharp.Server.HttpServer.Port

get

Gets the port of the server.

An int that represents the number of the port on which to listen for incoming requests.

◆ Realm

string WebSocketSharp.Server.HttpServer.Realm

getset

Gets or sets the name of the realm associated with the server.

The set operation works if the current state of the server is Ready or Stop.

A string that represents the name of the realm.

"SECRET AREA" is used as the name of the realm if the value is null or an empty string.

The default value is null.

◆ ReuseAddress

bool WebSocketSharp.Server.HttpServer.ReuseAddress

getset

Gets or sets a value indicating whether the server is allowed to be bound to an address that is already in use.

You should set this property to true if you would like to resolve to wait for socket in TIME_WAIT state.

The set operation works if the current state of the server is Ready or Stop.

true if the server is allowed to be bound to an address that is already in use; otherwise, false.

The default value is false.

◆ SslConfiguration

ServerSslConfiguration WebSocketSharp.Server.HttpServer.SslConfiguration

get

Gets the configuration for secure connection.

The configuration is used when the server attempts to start, so it must be configured before the start method is called.

A ServerSslConfiguration that represents the configuration used to provide secure connections.

例外

InvalidOperationException The server does not provide secure connections.

◆ UserCredentialsFinder

Func<IIdentity, NetworkCredential> WebSocketSharp.Server.HttpServer.UserCredentialsFinder

getset

Gets or sets the delegate called to find the credentials for an identity used to authenticate a client.

The set operation works if the current state of the server is Ready or Stop.

A T:System.Func<IIdentity, NetworkCredential> delegate.

It represents the delegate called when the server finds the credentials used to authenticate a client.

It must return null if the credentials are not found.

null if not necessary.

The default value is null.

◆ WaitTime

TimeSpan WebSocketSharp.Server.HttpServer.WaitTime

getset

Gets or sets the time to wait for the response to the WebSocket Ping or Close.

The set operation works if the current state of the server is Ready or Stop.

A TimeSpan that represents the time to wait for the response.

The default value is the same as 1 second.

例外

ArgumentOutOfRangeException The value specified for a set operation is zero or less.

◆ WebSocketServices

WebSocketServiceManager WebSocketSharp.Server.HttpServer.WebSocketServices

get

Gets the management function for the WebSocket services provided by the server.

A WebSocketServiceManager that manages the WebSocket services provided by the server.

このクラス詳解は次のファイルから抽出されました:

SkyWayUnitySDK/Assets/SkyWay/Scripts/Deps/websocket-sharp/websocket-sharp/Server/HttpServer.cs

公開メンバ関数

プロパティ

イベント

詳解

構築子と解体子

◆ HttpServer() [1/6]

◆ HttpServer() [2/6]

◆ HttpServer() [3/6]

◆ HttpServer() [4/6]

◆ HttpServer() [5/6]

◆ HttpServer() [6/6]

関数詳解

◆ AddWebSocketService< TBehavior >() [1/2]

◆ AddWebSocketService< TBehavior >() [2/2]

◆ RemoveWebSocketService()

◆ Start()

◆ Stop()

プロパティ詳解

◆ Address

◆ AuthenticationSchemes

◆ DocumentRootPath

◆ IsListening

◆ IsSecure

◆ KeepClean

◆ Log

◆ Port

◆ Realm

◆ ReuseAddress

◆ SslConfiguration

◆ UserCredentialsFinder

◆ WaitTime

◆ WebSocketServices