client-api

classes that are needed for the android client

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

Download client-api

Filename	Size
client-api-0.1.5.pom
client-api-0.1.5.jar	15 KB
client-api-0.1.5-sources.jar	13 KB
client-api-0.1.5-javadoc.jar	99 KB

How to add to project

Apache Maven

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

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.antennaesdk.common/client-api/
implementation 'com.github.antennaesdk.common:client-api:0.1.5'

Gradle Kotlin

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

Apache Buildr

'com.github.antennaesdk.common:client-api:jar:0.1.5'

Apache Ivy

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

Groovy Grape

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

Scala SBT

libraryDependencies += "com.github.antennaesdk.common" % "client-api" % "0.1.5"

Leiningen

[com.github.antennaesdk.common/client-api "0.1.5"]

Dependencies

compile (3)

Group / Artifact	Type	Version
org.hibernate.javax.persistence : hibernate-jpa-2.1-api	jar	1.0.0.Final
com.google.code.gson : gson	jar	2.7
org.json : json	jar	20160212

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.5 Jul 23, 2016
0.1.4 Jul 23, 2016
0.1.3 Jul 23, 2016