Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "ECF/Servers"

< ECF
m
 
(50 intermediate revisions by 12 users not shown)
Line 1: Line 1:
==ECF Generic Provider Server==
+
==ECF Generic Server==
[[Eclipse Communication Framework Project|ECF]] is currently using the [http://www.eclipse.org/equinox/documents/http_in_container.php Equinox Servlet Incubator] to run and support the example collab application running on the 'ECF generic' provider.
+
  
===Accessing the ECF Server for Real-Time Collaboration===
+
ECF Generic Servers can now be created, started, and managed dynamically using the [http://download.eclipse.org/rt/ecf/3.5Test/javadoc/org/eclipse/ecf/server/generic/IGenericServerContainerGroupFactory.html IGenericServerContainerGroupFactory] service started in the bundle activator of the org.eclipse.ecf.server.generic bundle.
#[http://www.eclipse.org/ecf/downloads.php Download] and install the ECF SDK.
+
#Right-click on a project within your workspace.
+
#Choose 'ECF' -> 'Connect Project...' from the popup menu.
+
#Select the 'ECF generic' provider from the list.
+
#Use '''ecftcp://ecf.eclipse.org:3282/server''' as the connect URI.
+
#Choose a nickname and then select the 'OK' button.
+
  
===Starting up the ECF Server from within Eclipse===
+
Here some example code for creating/starting a simple ECF generic server
#In this context, we'll assume that you're trying to do some development with ECF and have checked out the latest sources from CVS. If you have not already done so, you can go to the [http://www.eclipse.org/ecf/dev_resources.php development resources] and pick up the team project set files.
+
#Once you've got your workspace setup, open up the '''org.eclipse.ecf.provider''' project and wait for it to build completely if you have not already.
+
#You should now click on the dropdown arrow of the green 'Run' button and then click on 'Run...'.
+
#In the 'Java Application' tree node, expand it and then find the 'ECF Server Application' launch configuration.
+
#Click on the 'Run' button on the bottom right-hand corner and your workstation will not become an 'ECF generic' server!
+
  
==Future==
+
<pre>
We have lots more planned for the ECF servers sub-project, including:
+
// Get generic server container group factory service...e.g. via declarative service injection
 +
// or via ServiceTracker
 +
IGenericServerContainerGroupFactory genericServerFactory = <get IGenericServerContainerGroupFactory service>;
  
Running other providers on the server
+
// Create generic server container group for localhost, listen port=3282
 +
IGenericServerContainerGroup containerGroup = genericServerFactory.createContainerGroup("localhost",3282);
  
* xmpp
+
// Create an ECF container within the container group, and give it path="/server"
* zeroconf discovery
+
// The resulting container's ID will be:  ecftcp://localhost:3282/server
...
+
containerGroup.createContainer("/server");
  
[[Category:Eclipse Communication Framework|Servers]]
+
// start listening for client connections
 +
containerGroup.startListening();
 +
</pre>
 +
 
 +
{{ECF}}
 +
 
 +
[[Category:Eclipse Communication Framework]]
 +
[[Category:ECF]]
 +
[[Category:Servers]]

Latest revision as of 15:36, 14 March 2011

ECF Generic Server

ECF Generic Servers can now be created, started, and managed dynamically using the IGenericServerContainerGroupFactory service started in the bundle activator of the org.eclipse.ecf.server.generic bundle.

Here some example code for creating/starting a simple ECF generic server

// Get generic server container group factory service...e.g. via declarative service injection
// or via ServiceTracker
IGenericServerContainerGroupFactory genericServerFactory = <get IGenericServerContainerGroupFactory service>;

// Create generic server container group for localhost, listen port=3282
IGenericServerContainerGroup containerGroup = genericServerFactory.createContainerGroup("localhost",3282);

// Create an ECF container within the container group, and give it path="/server"
// The resulting container's ID will be:  ecftcp://localhost:3282/server
containerGroup.createContainer("/server");

// start listening for client connections
containerGroup.startListening();
Eclipse Communication Framework
API
API DocumentationJavadocProviders
Development
Development GuidelinesIntegrators Guide

Back to the top