https://github.com/dimchat/sdk-java
Decentralized Instant Messaging (Java SDK)
https://github.com/dimchat/sdk-java
Last synced: 5 months ago
JSON representation
Decentralized Instant Messaging (Java SDK)
- Host: GitHub
- URL: https://github.com/dimchat/sdk-java
- Owner: dimchat
- License: mit
- Created: 2019-11-04T07:31:15.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2026-01-13T19:50:41.000Z (5 months ago)
- Last Synced: 2026-01-13T21:44:10.421Z (5 months ago)
- Language: Java
- Size: 1.48 MB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Decentralized Instant Messaging (Java SDK)
[](https://github.com/dimchat/sdk-java/blob/master/LICENSE)
[](https://github.com/dimchat/sdk-java/pulls)
[](https://github.com/dimchat/sdk-java/wiki)
[](https://github.com/dimchat/sdk-java/issues)
[](https://github.com/dimchat/sdk-java/archive/refs/heads/master.zip)
[](https://github.com/dimchat/sdk-java/tags)
[](https://mvnrepository.com/artifact/chat.dim/SDK)
[](https://github.com/dimchat/sdk-java/watchers)
[](https://github.com/dimchat/sdk-java/forks)
[](https://github.com/dimchat/sdk-java/stargazers)
[](https://github.com/orgs/dimchat/followers)
## Dependencies
* Latest Versions
| Name | Version | Description |
|------|---------|-------------|
| [Ming Ke Ming (名可名)](https://github.com/dimchat/mkm-java) | [](https://mvnrepository.com/artifact/chat.dim/MingKeMing) | Decentralized User Identity Authentication |
| [Dao Ke Dao (道可道)](https://github.com/dimchat/dkd-java) | [](https://mvnrepository.com/artifact/chat.dim/DaoKeDao) | Universal Message Module |
| [DIMP (去中心化通讯协议)](https://github.com/dimchat/core-java) | [](https://mvnrepository.com/artifact/chat.dim/DIMP) | Decentralized Instant Messaging Protocol |
* build.gradle
```javascript
allprojects {
repositories {
mavenLocal()
mavenCentral()
google()
}
}
dependencies {
// https://central.sonatype.com/artifact/chat.dim/SDK
implementation group: 'chat.dim', name: 'SDK', version: '2.0.0'
}
```
* pom.xml
```xml
chat.dim
SDK
2.0.0
pom
```
## Extensions
### Content
extends [CustomizedContent](https://github.com/dimchat/core-java#extends-content)
### ContentProcessor
```java
import java.util.HashMap;
import java.util.Map;
import chat.dim.Facebook;
import chat.dim.Messenger;
import chat.dim.cpu.app.CustomizedContentHandler;
import chat.dim.protocol.CustomizedContent;
import chat.dim.protocol.ReliableMessage;
/**
* Customized Content Processing Unit
*
* Handle content for application customized
*
*/
public class AppCustomizedProcessor extends CustomizedContentProcessor {
private final Map handlers = new HashMap<>();
public AppCustomizedProcessor(Facebook facebook, Messenger messenger) {
super(facebook, messenger);
}
public void setContentHandler(String app, String mod, CustomizedContentHandler handler) {
handlers.put(app + ":" + mod, handler);
}
protected CustomizedContentHandler getContentHandler(String app, String mod) {
return handlers.get(app + ":" + mod);
}
@Override
protected CustomizedContentHandler filter(String app, String mod, CustomizedContent content, ReliableMessage rMsg) {
CustomizedContentHandler handler = getContentHandler(app, mod);
if (handler != null) {
return handler;
}
// default handler
return super.filter(app, mod, content, rMsg);
}
}
```
```java
import java.util.List;
import java.util.Map;
import chat.dim.Facebook;
import chat.dim.Messenger;
import chat.dim.protocol.*;
import chat.dim.protocol.group.*;
/* Command Transform:
+===============================+===============================+
| Customized Content | Group Query Command |
+-------------------------------+-------------------------------+
| "type" : i2s(0xCC) | "type" : i2s(0x88) |
| "sn" : 123 | "sn" : 123 |
| "time" : 123.456 | "time" : 123.456 |
| "app" : "chat.dim.group" | |
| "mod" : "history" | |
| "act" : "query" | |
| | "command" : "query" |
| "group" : "{GROUP_ID}" | "group" : "{GROUP_ID}" |
| "last_time" : 0 | "last_time" : 0 |
+===============================+===============================+
*/
public final class GroupHistoryHandler extends BaseCustomizedHandler {
public GroupHistoryHandler(Facebook facebook, Messenger messenger) {
super(facebook, messenger);
}
@Override
public List handleAction(String act, ID sender, CustomizedContent content, ReliableMessage rMsg) {
if (content.getGroup() == null) {
assert false : "group command error: " + content + ", sender: " + sender;
return respondReceipt("Group command error.", rMsg.getEnvelope(), content, null);
}
if (GroupHistory.ACT_QUERY.equals(act)) {
assert GroupHistory.APP.equals(content.getApplication());
assert GroupHistory.MOD.equals(content.getModule());
return transformQueryCommand(content, rMsg);
}
assert false : "unknown action: " + act + ", " + content + ", sender: " + sender;
return super.handleAction(act, sender, content, rMsg);
}
private List transformQueryCommand(CustomizedContent content, ReliableMessage rMsg) {
Messenger messenger = getMessenger();
if (messenger == null) {
assert false : "messenger lost";
return null;
}
Map info = content.copyMap(false);
info.put("type", ContentType.COMMAND);
info.put("command", GroupCommand.QUERY);
Content query = Content.parse(info);
if (query instanceof QueryCommand) {
return messenger.processContent(query, rMsg);
}
assert false : "query command error: " + query + ", " + content + ", sender: " + rMsg.getSender();
return respondReceipt("Query command error.", rMsg.getEnvelope(), content, null);
}
}
```
### ContentProcessorCreator
```java
import chat.dim.Facebook;
import chat.dim.Messenger;
import chat.dim.cpu.app.GroupHistoryHandler;
import chat.dim.dkd.ContentProcessor;
import chat.dim.protocol.*;
import chat.dim.protocol.group.GroupHistory;
public class ClientContentProcessorCreator extends BaseContentProcessorCreator {
public ClientContentProcessorCreator(Facebook facebook, Messenger messenger) {
super(facebook, messenger);
}
protected AppCustomizedProcessor createCustomizedContentProcessor(Facebook facebook, Messenger messenger) {
AppCustomizedProcessor cpu = new AppCustomizedProcessor(facebook, messenger);
// 'chat.dim.group:history'
cpu.setContentHandler(
GroupHistory.APP,
GroupHistory.MOD,
new GroupHistoryHandler(facebook, messenger)
);
return cpu;
}
@Override
public ContentProcessor createContentProcessor(String msgType) {
switch (msgType) {
// application customized
case ContentType.APPLICATION:
case "application":
case ContentType.CUSTOMIZED:
case "customized":
return createCustomizedContentProcessor(getFacebook(), getMessenger());
// ...
}
// others
return super.createContentProcessor(msgType);
}
@Override
public ContentProcessor createCommandProcessor(String type, String name) {
switch (name) {
case HandshakeCommand.HANDSHAKE:
return new HandshakeCommandProcessor(getFacebook(), getMessenger());
// ...
}
// others
return super.createCommandProcessor(type, name);
}
}
```
## Usage
To let your **AppCustomizedProcessor** start to work,
you must override ```BaseContentProcessorCreator``` for message types:
1. ContentType.APPLICATION
2. ContentType.CUSTOMIZED
and then set your **creator** for ```GeneralContentProcessorFactory``` in the ```MessageProcessor```.
----
Copyright © 2018-2025 Albert Moky
[](https://github.com/moky?tab=followers)