Java project for running the client part of the chat program
Project
master-branch (alias stable, latest)
develop-branch (alias nightly)
Use a console version or GUI version. When running there are additional options (check the usage part).
- ✔ Set server address and port
- ✔ Create new login
- ✔ Change password
- ✔ Delete account
- ✔ Login
- ✔ Logout
- ✔ List group chats
- ✔ Join a particular group chats
- ✔ See messages in the group chats
- ✔ Send a message to the group chats
- ✔ MVC structure: Separate the UI from the logic
- ✔ Multilingual application: English, German, Italian, French
- ✔ Reasonable user interface
- ✔ Platform independent
- ✔ User errors do not crash the program
- ✔ Controls enable/disable as appropriate
- ❌ Display status of contact
- ✔ Be able to send/receive private messages to a contact
- ✔ How will you distinguish private messages from public chat? Different tabs!
- ❌ Users whose private messages will be ignored
- ❌ Users whose chat room messages will not be displayed
- ❌ Are these the same users, or two different lists?
- ✔ Nice design, good use of color
- ✔ Good error messages
- ✔ Sensible resizing behavior
- ✔ All controls enabled/disabled when it makes sense
- ✔ Subjective…
- ❌ For example: animations for user feedback
- ❌ Logout / Login – pick up where you left off (Annoying feature)
- ❌ Display list of users in the group chats
- ✔ Be able to join multiple chat rooms
- ❌ Manage a private chat room (Add and remove users)
- ✔ Maintain long-term history of chats
- ❌ Be able to select portion of chat to look at
- ❌ Offer search/filter functionality – by user, by content, by date
Import to your IDE and run
When running you can add following options:
| Short | Long | Description |
|---|---|---|
| -g | --no-gui | Uses the console as interface instead of a window |
| -d | --no-db | Don't use the internal db. Data will never be saved. |
| -l | --db-location | If using a DB (by default on), use a custom location for the file |
| -v | --verbose | Show more information in the console. Useful for debuggin and finding errors. |
- Official site: http://javaprojects.ch
- Official ip: 147.86.8.31
- Official port: 50001
| MessageType | Data | Notes |
|---|---|---|
| CreateLogin | Username, Password | Fails if name already taken (user or group chat), or invalid After creating an account, you still have to login |
| Login | Username, Password | Fails if name/password do not match |
| ChangePassword | New password | Fails only if token is invalid |
| DeleteLogin | - | Fails only if token is invalid; after delete, token becomes invalid |
| Logout | - | Never fails; token becomes invalid |
| CreateChatroom | Name, isPublic | Fails if name already taken (user or group chat), or invalid After creating a group chat, you still have to join |
| JoinChatroom | Chatroom, User | User can add themselves to public group chat Only the creator can add user to a private group chat |
| LeaveChatroom | Chatroom, User | You can always remove yourself. Group chat creator can remove anyone |
| DeleteChatroom | Chatroom | Only the creator can delete a group chat |
| ListChatrooms | - | Returns a list of all public group chats |
| Ping | Token | Without a token: always succeeds With token: succeeds only if token is valid |
| SendMessage | Target, Message | Send message to user or group chat. Fails if user not online / Fails if not a member of the group chat |
| UserOnline | User | Succeeds if the user is currently logged in |
| ListChatroomUsers | Chatroom | Returns a list of all users in the given group chat. You must be a member of this group chat |
| MessageType | Data | Notes |
|---|---|---|
| Result | Boolean Boolean Token Boolean List | True if the command succeeded, otherwise false After a successful login, also returns the authentication token When a list is requested, also returns list results |
| MessageError | Error message | Incorrect commands, wrong number of arguments, etc. |
| MessageType | Data | Notes |
|---|---|---|
| MessageText | Name, Target, Text | Name of user sending message Target is where the message was sent (group chat or user) Text of the message |
- Maven - Dependency Management
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
We use SemVer for versioning. For the versions available, see the tags on this repository.
- Manuele Vaccari - Initial work - D3strukt0r
See also the list of contributors who participated in this project.
This project is licensed under the GNU General Public License v3.0 - see the LICENSE.txt file for details.
- Hat tip to anyone whose code was used
- Inspiration
- etc
