A buddycloud server written in Java, implementing the buddycloud channels protocol.

Note this points to the main buddycloud repository for the java server.

The java server purposefully uses the same database schema as the buddycloud node.js server. See here for database installation instructions https://github.com/buddycloud/buddycloud-server/tree/develop/postgres.

• install openjdk-6-jdk maven
• git clone https://github.com/buddycloud/buddycloud-server-java
• cd buddycloud-server-java
• mvn package
• Edit configuration files as required
• Install database
• java -jar target/channelserver-<VERSION>-jar-with-dependencies.jar

# switch to the postgres user
sudo su - postgres

Create a database user and assign it a password (it will not work with a blank password);

createuser buddycloud_server --pwprompt --no-superuser --no-createdb --no-createrole

Then just proceed as follows, entering the password you picked whenever asked.

# create the database
createdb --owner buddycloud_server --encoding UTF8 buddycloud_server

# install the schema file (and all upgrade files)
psql -h 127.0.0.1 -U buddycloud_server -d buddycloud_server < postgres/install.sql
psql -h 127.0.0.1 -U buddycloud_server -d buddycloud_server < postgres/upgrade-1.sql
psql -h 127.0.0.1 -U buddycloud_server -d buddycloud_server < postgres/upgrade-2.sql

Now we're done, but we must test that we can connect to the database and that the schema was installed appropriately.

psql -h 127.0.0.1 --username buddycloud_server -d buddycloud_server -c "select * from nodes;"

If you got an output similar to (or exactly like) this, you're good to go.

The buddycloud server supports validation of custom content types by means of a plugin system. By default the buddycloud server supports Atom content. Additional content types can be supported by creating an appropriate validator and packaging it as a plugin.

The plugin system is not invoked if the content type is not supplied or is the default, Atom. If the plugin manager is queried then it locates an appropriate plugin based on the capabilities reported by each plugin. So we are able to directly request a plugin capable of validating a specific payload type.

The buddycloud plugin system is based on JSPF. Plugins are added to the main application as JAR files, dropped into the plugins/ directory.

Creating new validator plugins is simple, there are a few simple rules to follow. Validator plugins must implement the PayloadValidator interface and be annotated with @PluginImplementation. To publish the capabilities of your plugin you must include a capabilities() method and annotate it with @Override

Two example plugins are available. One provides support for validating IODEF payloads while the other is based on the default Atom validator. Note that Atom support is built into buddycloud server so there is no need to add the Atom plugin to your installation, it merely serves as an example.

1. Create a plugins directory in the root of your buddycloud installation, e.g. target/plugins/.
2. Drop your plugin JAR into the plugins directory you created in step 1.
3. Restart your Buddycloud server.

To declare the content type for a node you must set the node configuration key pubsub#type to the appropriate validator value. For example, in the case of IODEF urn:ietf:params:xml:ns:iodef-1.0.