server-api

classes that are needed for the server side clients

License	Apache License, Version 2.0
Categories	Ant Build Tools
GroupId	com.github.antennaesdk.common
ArtifactId	server-api
Last Version	0.1.6
Release Date	Jul 23, 2016
Type	jar
Description	server-api classes that are needed for the server side clients
Source Code Management	https://github.com/AntennaeSDK/MMS/tree/master/server-api

Download server-api

Filename	Size
server-api-0.1.6.pom
server-api-0.1.6.jar	8 KB
server-api-0.1.6-sources.jar	7 KB
server-api-0.1.6-javadoc.jar	30 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.antennaesdk.common/server-api/ -->
<dependency>
    <groupId>com.github.antennaesdk.common</groupId>
    <artifactId>server-api</artifactId>
    <version>0.1.6</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.antennaesdk.common/server-api/
implementation 'com.github.antennaesdk.common:server-api:0.1.6'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.antennaesdk.common/server-api/
implementation ("com.github.antennaesdk.common:server-api:0.1.6")

Apache Buildr

'com.github.antennaesdk.common:server-api:jar:0.1.6'

Apache Ivy

<dependency org="com.github.antennaesdk.common" name="server-api" rev="0.1.6">
  <artifact name="server-api" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.antennaesdk.common', module='server-api', version='0.1.6')
)

Scala SBT

libraryDependencies += "com.github.antennaesdk.common" % "server-api" % "0.1.6"

Leiningen

[com.github.antennaesdk.common/server-api "0.1.6"]

Dependencies

compile (1)

Group / Artifact	Type	Version
com.github.antennaesdk.common : client-api	jar	0.1.6-SNAPSHOT

Project Modules

There are no modules declared in this project.

MMS Mobile Messaging Server

MMS acts as bridge between client apps and server apps, while abstracting the complexities of real-world networks from server applications.

Architecture

MMS seamlessly abstracts the complexities of real-world networks where client apps exist from the server applications.

For more details, please read the Architecture

Features

1. Client Apps use one TCP connection to interact with the server(s) whether they are REST APIs or messaging APIs
2. The messages from Server(s) are routed based on priority and availability of the client
3. Client Apps can talk to legacy server apps without compromising performance

Setup

Java 8 should be installed.

Download MMS.war file

Download latest version of MMS.war from maven central

Usage

java -jar mms-<m.n.p>.war --help

Configuration File

MMS needs to be supplied with following configuration

1. GCM senderId and ApiKey
2. If SSL is enabled, SSL certificate, keystore and passwords
3. Port numbers ( default http port is 8080, default https port is 8443 )

A sample configuration file can be generated

Generate sample configuration file

generates the sample config files under "config" folder

java -jar mms-<m.n.p>.war -g

Start MMS

## make sure java 8 is available
java -version

## start mms
java -jar mms-<m.n.p>.war -c <config-dir>

FAQ

1. How to create the keystore and store certificates? Official documentation from java provides the details, besides there are several online resources that provide documenation about keytool.

   Official Keytool Docs

   Command to create a keystore and self-signed certificate

2. How to create GCM senderId and apiKey? Click on "Get A Configuration file button" https://developers.google.com/cloud-messaging/android/client#get-config

Versions

Version
0.1.6 Jul 23, 2016
0.1.5 Jul 23, 2016
0.1.4 Jul 23, 2016
0.1.3 Jul 23, 2016