Add notes for the new lead maintainer of the open-source iris project and align with @get-ion/ion by @hiveminded

Former-commit-id: da4f38eb9034daa49446df3ee529423b98f9b331
2025-12-22 04:17:03 +00:00 · 2017-07-10 18:32:42 +03:00
parent 2d4c2779a7
commit 9f85b74fc9
344 changed files with 4842 additions and 5174 deletions
--- a/websocket/_examples/native-messages/main.go
+++ b/websocket/_examples/native-messages/main.go
@@ -0,0 +1,63 @@
+package main
+
+import (
+	"fmt"
+
+	"github.com/kataras/iris"
+	"github.com/kataras/iris/context"
+	"github.com/kataras/iris/view"
+
+	"github.com/kataras/iris/websocket"
+)
+
+/* Native messages no need to import the iris-ws.js to the ./templates.client.html
+Use of: OnMessage and EmitMessage.
+
+
+NOTICE: IF YOU HAVE RAN THE PREVIOUS EXAMPLES YOU HAVE TO CLEAR YOUR BROWSER's CACHE
+BECAUSE chat.js is different than the CACHED. OTHERWISE YOU WILL GET Ws is undefined from the browser's console, because it will use the cached.
+*/
+
+type clientPage struct {
+	Title string
+	Host  string
+}
+
+func main() {
+	app := iris.New()
+
+	app.RegisterView(view.HTML("./templates", ".html")) // select the html engine to serve templates
+
+	ws := websocket.New(websocket.Config{
+	// to enable binary messages (useful for protobuf):
+	// BinaryMessages: true,
+	})
+
+	// register the server on an endpoint.
+	// see the inline javascript code i the websockets.html, this endpoint is used to connect to the server.
+	app.Get("/my_endpoint", ws.Handler())
+
+	app.StaticWeb("/js", "./static/js") // serve our custom javascript code
+
+	app.Get("/", func(ctx context.Context) {
+		ctx.ViewData("", clientPage{"Client Page", "localhost:8080"})
+		ctx.View("client.html")
+	})
+
+	ws.OnConnection(func(c websocket.Connection) {
+
+		c.OnMessage(func(data []byte) {
+			message := string(data)
+			c.To(websocket.Broadcast).EmitMessage([]byte("Message from: " + c.ID() + "-> " + message)) // broadcast to all clients except this
+			c.EmitMessage([]byte("Me: " + message))                                                    // writes to itself
+		})
+
+		c.OnDisconnect(func() {
+			fmt.Printf("\nConnection with ID: %s has been disconnected!", c.ID())
+		})
+
+	})
+
+	app.Run(iris.Addr(":8080"))
+
+}
--- a/websocket/_examples/native-messages/static/js/chat.js
+++ b/websocket/_examples/native-messages/static/js/chat.js
@@ -0,0 +1,38 @@
+var messageTxt;
+var messages;
+
+$(function () {
+
+	messageTxt = $("#messageTxt");
+	messages = $("#messages");
+
+
+	w = new WebSocket("ws://" + HOST + "/my_endpoint");
+	w.onopen = function () {
+		console.log("Websocket connection enstablished");
+	};
+
+	w.onclose = function () {
+		appendMessage($("<div><center><h3>Disconnected</h3></center></div>"));
+	};
+	w.onmessage = function(message){
+		appendMessage($("<div>" + message.data + "</div>"));
+	};
+
+
+	$("#sendBtn").click(function () {
+		w.send(messageTxt.val().toString());
+		messageTxt.val("");
+	});
+
+})
+
+
+function appendMessage(messageDiv) {
+    var theDiv = messages[0];
+    var doScroll = theDiv.scrollTop == theDiv.scrollHeight - theDiv.clientHeight;
+    messageDiv.appendTo(messages);
+    if (doScroll) {
+        theDiv.scrollTop = theDiv.scrollHeight - theDiv.clientHeight;
+    }
+}
--- a/websocket/_examples/native-messages/templates/client.html
+++ b/websocket/_examples/native-messages/templates/client.html
@@ -0,0 +1,21 @@
+<html>
+
+<head>
+<title>{{ .Title}}</title>
+</head>
+
+<body>
+	<div id="messages"
+		style="border-width: 1px; border-style: solid; height: 400px; width: 375px;">
+
+	</div>
+	<input type="text" id="messageTxt" />
+	<button type="button" id="sendBtn">Send</button>
+	<script type="text/javascript">
+		var HOST = {{.Host}}
+	</script>
+	<script src="js/vendor/jquery-2.2.3.min.js" type="text/javascript"></script>
+	<script src="js/chat.js" type="text/javascript"></script>
+</body>
+
+</html>