client-api

classes that are needed for the android client

License

License

Categories

Categories

Ant Build Tools CLI User Interface
GroupId

GroupId

com.github.antennaesdk.common
ArtifactId

ArtifactId

client-api
Last Version

Last Version

0.1.5
Release Date

Release Date

Type

Type

jar
Description

Description

client-api
classes that are needed for the android client
Source Code Management

Source Code Management

https://github.com/AntennaeSDK/MMS/tree/master/client-api

Download client-api

How to add to project

<!-- 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>
// https://jarcasting.com/artifacts/com.github.antennaesdk.common/client-api/
implementation 'com.github.antennaesdk.common:client-api:0.1.5'
// https://jarcasting.com/artifacts/com.github.antennaesdk.common/client-api/
implementation ("com.github.antennaesdk.common:client-api:0.1.5")
'com.github.antennaesdk.common:client-api:jar:0.1.5'
<dependency org="com.github.antennaesdk.common" name="client-api" rev="0.1.5">
  <artifact name="client-api" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.github.antennaesdk.common', module='client-api', version='0.1.5')
)
libraryDependencies += "com.github.antennaesdk.common" % "client-api" % "0.1.5"
[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
0.1.4
0.1.3