Although I should probably announce this earlier to the release, i would like to see what peoples opinions are on the project.
IonNetwork is essentially a server thats extremely customisable. The server itself comes as a executable and allows users to create plugins that interact with the server.
The server works with 'Requests'. These are json serialized classes that consist of the following data:
method - The name of the method the client is to access
parameters - An array of objects defined by a string 'key'.
The requests can be sent from both the client AND the server and are entirely processed by the code. All you have to do is handle them and send them.
So, what does it look like? Well, let me run through an example. Here is a basic 'skeleton' of a script:
Within this, you can see he standard 'plugin name' and 'plugin description'. These are descriptors that will be called by the server to identify plugins.
OnRequest and OnConnect are the main methods that will be called when a network client interacts with the server. OnConnect is called when a new client connects. Do remember that EVERY plugin will have a OnConnect. Within OnConnect, you can use it to send information such as version numbers etc. This would be achieved by the following:
This code would send a "serverinfo" packet to the client with their clientid and localtime of the server. You can then implement the handler on the client side to process this easily.
OnRequest is raised when a new request is sent by a client to the server. The request is sent to ALL plugins, again, so you need to bare this in mind.
Here is an example of OnRequest:
Now you're probably thinking "Yeah, that's cool, but it must be difficult to implement it on the client side". Well, infact, here's all you need to implement it on the client:
Every time a new request is called, the RequestHandler is called and that handles the request. Pretty neat, if you ask me!
The question is, would anybody be interested in playing around with this? I'll get it completed fairly shortly, but wanted to know if anybody fancied making some plugins or possibly creating a demo for it? In return you'll get a free license when it's released![/code]
IonNetwork is essentially a server thats extremely customisable. The server itself comes as a executable and allows users to create plugins that interact with the server.
The server works with 'Requests'. These are json serialized classes that consist of the following data:
method - The name of the method the client is to access
parameters - An array of objects defined by a string 'key'.
The requests can be sent from both the client AND the server and are entirely processed by the code. All you have to do is handle them and send them.
So, what does it look like? Well, let me run through an example. Here is a basic 'skeleton' of a script:
Code
class Plugin : IonNetwork.Plugins.IPlugin
{
public string GetPluginName()
{
return "Sample plugin";
}
public string GetPluginDescription()
{
return "This plugin handles the basics of a standard plugin and shows you what you can ";
}
public void OnRequest(IonNetwork.TcpNetworking.NetworkClient Client, IonNetwork.Networking.Request Request)
{
}
public void OnConnect(IonNetwork.TcpNetworking.NetworkClient Client)
{
}
}Within this, you can see he standard 'plugin name' and 'plugin description'. These are descriptors that will be called by the server to identify plugins.
OnRequest and OnConnect are the main methods that will be called when a network client interacts with the server. OnConnect is called when a new client connects. Do remember that EVERY plugin will have a OnConnect. Within OnConnect, you can use it to send information such as version numbers etc. This would be achieved by the following:
Code
public void OnConnect(IonNetwork.TcpNetworking.NetworkClient Client)
{
IonNetwork.Networking.Request request = new IonNetwork.Networking.Request("serverinfo"); // Takes a method name as a constructor
request.AddParameter("clientid", Client.uniqueId);
request.AddParameter("localtime", DateTime.Now);
}This code would send a "serverinfo" packet to the client with their clientid and localtime of the server. You can then implement the handler on the client side to process this easily.
OnRequest is raised when a new request is sent by a client to the server. The request is sent to ALL plugins, again, so you need to bare this in mind.
Here is an example of OnRequest:
Code
public void OnRequest(IonNetwork.TcpNetworking.NetworkClient Client, IonNetwork.Networking.Request Request)
{
if(Request.method == "authenticate")
{
if(Request.GetParameter("token") == "icanhazentry")
{
IonNetwork.Networking.Request request = new Request("authenticateresponse");
request.AddParameter("response", "ok");
}
}
}Now you're probably thinking "Yeah, that's cool, but it must be difficult to implement it on the client side". Well, infact, here's all you need to implement it on the client:
Code
Networking.NetworkConnection connection = new Networking.NetworkConnection("localhost", 8888);
connection.RequestHandlerEvent += new Networking.NetworkConnection.RequestHandler(Handler);
connection.NetworkErrorHandler += new Networking.NetworkConnection.NetworkError(ErrorHandler);
connection.Connect();Every time a new request is called, the RequestHandler is called and that handles the request. Pretty neat, if you ask me!
The question is, would anybody be interested in playing around with this? I'll get it completed fairly shortly, but wanted to know if anybody fancied making some plugins or possibly creating a demo for it? In return you'll get a free license when it's released![/code]
