Skip to content

Commit e2d36d1

Browse files
authored
[Feature-138 ] Update the main README (#140)
1 parent bb9358b commit e2d36d1

File tree

2 files changed

+148
-14
lines changed

2 files changed

+148
-14
lines changed

README.md

Lines changed: 139 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,152 @@
1-
# JMQTT-Broker
1+
# MQTT-Broker
22

3-
JMQTT-Broker is an open source (GPL v3) Java based MQTT Broker with network implementation based on Java.NIO.2
3+
MQTT-Broker is an open source Java based MQTT Broker which implements MQTT v3.1.1
4+
and v5.0 protocol versions based on core library: https://github.com/JavaSaBr/RLib
5+
6+
### Feature Map
7+
1. MQTT Protocol features:
8+
- [ ] Connection Request
9+
- [X] Base handling
10+
- [ ] CONNECT Variable Header
11+
- [ ] Clean Start
12+
- [ ] Will Flag
13+
- [ ] Will QoS
14+
- [ ] Will Retain
15+
- [ ] User Name Flag
16+
- [ ] Password Flag
17+
- [ ] Keep Alive
18+
- [ ] CONNECT Properties
19+
- [ ] Session Expiry Interval
20+
- [ ] Receive Maximum
21+
- [ ] Maximum Packet Size
22+
- [ ] Topic Alias Maximum
23+
- [ ] Request Problem Information
24+
- [X] User Property
25+
- [ ] Authentication Method
26+
- [ ] Authentication Data
27+
- [ ] CONNECT Payload
28+
- [X] Client Identifier
29+
- [ ] Will Properties
30+
- [ ] Will Delay Interval
31+
- [ ] Payload Format Indicator
32+
- [ ] Message Expiry Interval
33+
- [ ] Content Type
34+
- [ ] Response Topic
35+
- [ ] Correlation Data
36+
- [ ] User Property
37+
- [ ] Will Topic
38+
- [ ] Will Payload
39+
- [X] User Name
40+
- [X] Password
41+
- [ ] Connect acknowledgement
42+
- [X] Base handling
43+
- [ ] Session Present
44+
- [ ] CONNACK Properties
45+
- [ ] Session Expiry Interval
46+
- [ ] Receive Maximum
47+
- [X] Maximum QoS
48+
- [ ] Retain Available
49+
- [ ] Maximum Packet Size
50+
- [X] Assigned Client Identifier
51+
- [ ] Topic Alias Maximum
52+
- [ ] Reason String
53+
- [ ] User Property
54+
- [X] Wildcard Subscription Available
55+
- [X] Subscription Identifiers Available
56+
- [X] Shared Subscription Available
57+
- [ ] Server Keep Alive
58+
- [ ] Response Information
59+
- [ ] Server Reference
60+
- [ ] Authentication Method
61+
- [ ] Authentication Data
62+
- [ ] Publish message
63+
- [X] Base handling
64+
- [ ] RETAIN
65+
- [ ] PUBLISH Properties
66+
- [ ] Message Expiry Interval
67+
- [X] Payload Format Indicator
68+
- [ ] Topic Alias
69+
- [X] Response Topic
70+
- [X] User Property
71+
- [ ] Subscription Identifier
72+
- [X] Content Type
73+
- [X] Publish acknowledgement
74+
- [X] Base handling
75+
- [X] PUBACK Properties
76+
- [X] Reason String
77+
- [X] User Property
78+
- [X] Publish received
79+
- [X] Base handling
80+
- [X] PUBREC Properties
81+
- [X] Reason String
82+
- [X] User Property
83+
- [X] Publish release
84+
- [X] Base handling
85+
- [X] PUBREL Properties
86+
- [X] Reason String
87+
- [X] User Property
88+
- [X] Publish complete
89+
- [X] Base handling
90+
- [X] PUBCOMP Properties
91+
- [X] Reason String
92+
- [X] User Property
93+
- [ ] Subscribe request
94+
- [X] Base handling
95+
- [ ] SUBSCRIBE Properties
96+
- [ ] Subscription Identifier
97+
- [X] User Property
98+
- [ ] Subscription Options
99+
- [ ] Retain Handling
100+
- [ ] Retain as Published
101+
- [ ] No Local
102+
- [X] Subscribe acknowledgement
103+
- [X] Base handling
104+
- [X] SUBACK Properties
105+
- [X] Reason String
106+
- [X] User Property
107+
- [X] Unsubscribe request
108+
- [X] Base handling
109+
- [X] UNSUBSCRIBE Properties
110+
- [X] User Property
111+
- [X] Unsubscribe acknowledgement
112+
- [X] Base handling
113+
- [X] UNSUBACK Properties
114+
- [X] Reason String
115+
- [X] User Property
116+
- [ ] PING request
117+
- [ ] PING response
118+
- [ ] Disconnect notification
119+
- [X] Base handling
120+
- [ ] DISCONNECT Properties
121+
- [ ] Session Expiry Interval
122+
- [X] Reason String
123+
- [X] User Property
124+
- [ ] Server Reference
125+
- [ ] Authentication exchange
126+
- [X] Base handling
127+
- [ ] AUTH Properties
128+
- [ ] Authentication Method
129+
- [ ] Authentication Data
130+
- [ ] Reason String
131+
- [ ] User Property
132+
2. Extra features:
133+
- [ ] ACL Service
134+
- [ ] Disabled ACL
135+
- [ ] Static file based ACL
136+
- [ ] Authentication Service
4137

5138
## Dependencies for building
6-
### java 13+
7-
##### Ubuntu:
8-
```bash
9-
sudo wget -qO - https://adoptopenjdk.jfrog.io/adoptopenjdk/api/gpg/key/public | sudo apt-key add -
10-
sudo add-apt-repository --yes https://adoptopenjdk.jfrog.io/adoptopenjdk/deb/
11-
sudo apt-get install adoptopenjdk-13-hotspot
12-
```
13-
##### Windows: [Windows x64 installer](https://github.com/AdoptOpenJDK/openjdk13-binaries/releases/download/jdk-13.0.1%2B9/OpenJDK13U-jdk_x64_windows_hotspot_13.0.1_9.msi)
14-
##### MacOS: [MacOS x64 installer](https://github.com/AdoptOpenJDK/openjdk13-binaries/releases/download/jdk-13.0.1%2B9/OpenJDK13U-jdk_x64_mac_hotspot_13.0.1_9.pkg)
139+
### java 25+
140+
#### [Temurin JDK](https://adoptium.net/temurin/releases)
15141
### Docker
16142
##### Ubuntu: [installation guide](https://docs.docker.com/install/linux/docker-ce/ubuntu)
17143
##### Windows: [installation guide](https://docs.docker.com/docker-for-windows/install)
18144
##### MacOS: [installation guide](https://docs.docker.com/docker-for-mac/install)
19145
## Build
20146
```bash
21-
./gradlew buildSingleArtifact
147+
./gradlew :application:bootJar
22148
```
23149
## Run
24150
```bash
25-
./gradlew bootRun
151+
./gradlew :application:bootRun
26152
```

application/build.gradle

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,4 +24,12 @@ tasks.withType(GroovyCompile).configureEach {
2424
configurations.each {
2525
it.exclude group: "org.slf4j", module: "slf4j-log4j12"
2626
it.exclude group: "org.springframework.boot", module: "spring-boot-starter-logging"
27-
}
27+
}
28+
29+
bootRun {
30+
mainClass = "javasabr.mqtt.broker.application.MqttBrokerApplication"
31+
}
32+
33+
bootJar {
34+
mainClass = "javasabr.mqtt.broker.application.MqttBrokerApplication"
35+
}

0 commit comments

Comments
 (0)