machat

README

MaChat

---

An open source chat server implemented in pure Go. The chat server listens on a TCP port and/or a websocket. It supports the following concepts:

• Chat clients: A chat client represents the person who is sending and receiving messages
• Chat rooms: A chat room is a place where multiple chat clients can be added. All clients connected to the same chat room will be able to see their messages

Pull requests are more than welcome

---

How it works?

• The MaChat server listens on a TCP server as well as a websocket server specified by you for incoming messages
• A MaChat client starts the connection by:
  • Establishing a TCP or a websocket connection to the MaChat server port
  • Sending a JSON string message to indicate that chat client name as well as the name of the chat room that the client would like to join. The JSON format looks like this: {"name": "Mina", "room":"devroom"}
  • Chat rooms can be shared between TCP clients and websocket clients based on how the chat API is initialized

Once the name and chat room is sent to the chat server, the client can then proceed to send string messages via TCP or websockets, the server will route the messages to the appropriate chat room and share them with other clients in the chat room.

---

How to run the server?

The MaChat server supports two user flags:

• '-tcp' which is used to indicate the TCP server listening address. The default value is "localhost:8989"
• '-ws' which is used to indicate the websocket server listening address. The default value is "localhost:8099"

Example command:

<executablename> -tcp localhost:8989 -ws localhost:8099

'executablename' here is the name of the executable you build for the chat server. If you would like to run the code directly from the go code:

#Run the chat server with the default port
go run cmd/machat/machat.go

There is an example TCP chat client application code provided which supports three user flags:

• '-client' : for client name
• '-room': for chat room name
• '-address': for the TCP address of the chat server, defaulted to localhost:8989

To run the example client application with client name 'Mina' and chat room 'dev':

go run cmd/examplechatclient/chattcpclient.go -client Mina -room dev

There is also an example for a websocket client application which supports four user flags:

• '-client' : for client name
• '-room': for chat room name
• '-origin': for origin header field of the websocket
• '-address': for the TCP address of the chat server, defaulted to localhost:8099

---

What's checked in?

• ./gotcpchat.go: entry point to the chat TCP server code
• ./gowschat.go: entry point to the chat websocket server code
• ./chatapi/clients.go: code to handle the chat clients, the code is exposed as an API to be used by gotcpchat.go
• ./chatapi/rooms.go: code to handle chat rooms, the code is exposed as an API to be used by gotcpchat.go
• ./cmd/machat/machat.go: main package for the MaChat TCP server, you need to build this file to get the executable for the chat server
• ./cmd/examplechatclients/chattcpclient.go: main package for an example tcp client that can connect to the chat server
• ./cmd/examplechatclients/chatwebsocketclient.go: main package for an example tcp client that can connect to the chat server

---

For other articles and tutorials, check my website at www.minaandrawos.com

Documentation

Index

• func RunTCP(connection string) error
• func RunTCPWithExistingAPI(connection string, chat *chatapi.ChatAPI) error
• func RunWSChat(url, address string, Rbsize, Wbsize int) error
• func RunWSChatWithExistingAPI(url, address string, Rbsize, Wbsize int, chat *chatapi.ChatAPI) error

Functions

func RunTCP

func RunTCP(connection string) error

RunTCP will start chat tcp server on the provided connection string

func RunTCPWithExistingAPI

func RunTCPWithExistingAPI(connection string, chat *chatapi.ChatAPI) error

RunTCPWithExistingAPI will start chat tcp server on the provided connection string using an existing chat api session

func RunWSChat

func RunWSChat(url, address string, Rbsize, Wbsize int) error

RunWSChat starts a websocket chat server

func RunWSChatWithExistingAPI

func RunWSChatWithExistingAPI(url, address string, Rbsize, Wbsize int, chat *chatapi.ChatAPI) error

RunWSChatWithExistingAPI starts a websocket chat server with an existing chat api session