michael-dam-mEZ3PoFGs_k-unsplash.jpg
blocshop
September 23, 2020
0 min read

TCP networking in Cordova

TCP networking in Cordova.jpeg

Network communication is trivial in Cordova based projects. You have two main options to communicate with a server: HTTP or WebSockets.
You start having problems when you want to use something more low level. For example, if you want to implement a client to communicate with legacy services (like Telnet, IRC, etc), you need to use native TCP sockets.

Current W3C web APIs don’t expose any standardized interface and proposals like TCPSocket (https://developer.mozilla.org/en-US/docs/Web/API/TCPSocket) are still far from being implemented in web browsers.

We wanted to implement a phone and tablet application for online chess playing, that runs on three major operating systems: iOS, Android, and Windows Phone. We didn’t want to reinvent the wheel, by implementing our own chess server, so we decided to build the application on the time-honored Free Internet Chess Server (http://www.freechess.org/).

The problem is that FICS uses old fashioned TCP text based protocol, so the use of standard Web API was not an option. We could use websocket-to-socket bridge with intermediate service, but it requires hosting of service on some infrastructure, and it slightly worse reliability. Finally, we decided to implement our own Cordova plugin for TCP communication. I’ll describe it here in this blog post.

Usage

You can install plugin to your Cordova project with command line:

cordova plugin add cz.blocshop.socketsforcordova

Usage is simple, you just have to create instance of socket object:

var socket = new Socket();

Then you need to setup data consumer, error and close handlers:

socket.onData = function(data) { // invoked after new batch of data is received (typed array of bytes Uint8Array) }; socket.onError = function(errorMessage) { // invoked after error occurs during connection }; socket.onClose = function(hasError) { // invoked after connection close };

Finally you can connect to server:

socket.open( "someremoteserver.com", 1234, function() { // invoked after successful opening of socket }, function(errorMessage) { // invoked after unsuccessful opening of socket });

At this point, socket instance is in connected state and you started to receive events to handlers you setup above.
Write method of the socket accepts only Uint8Array, so you have to convert your string data. This code shows how to do it:

var dataString = "Hello world"; var data = new Uint8Array(dataString.length); for (var i = 0; i

There are 2 options of how to close the connection.

1) You can close the connection gracefully by sending FIN packet using shutdownWrite method:

socket.shutdownWrite();

After you call this method, you should wait until server sends all data to you and closes the connection. After that, you receive socket.onClose event.

2) Second options is to close socket immediately:

socket.close();

You receive socket.onClose event shortly after you call this method. Writing data to closed socket is not allowed.

More information

We created a sample Cordova project on GitHub:
https://github.com/blocshop/sockets-for-cordova-tester

The Cordova plugin itself is also available on GitHub:
https://github.com/blocshop/sockets-for-cordova

To see how this plugin works in a real-world application, you can download our Blindfold Chess Trainer game in your mobile app store (AndroidiOS) and play online. Enjoy!

Noir chess - blindfold chess trainer.png

Learn more from our insights

Top 15 micro-SaaS ideas for your startup in 2023.png
December 06, 2021

Top 15 micro-SaaS ideas for your startup in 2022

What exactly do we mean by micro SaaS? Micro Saas solutions use a web browser or mobile app interface. Micro SaaS solutions usually come about through the effort of an individual or very small team. It aims to solve precise problems. Micro SaaS projects have small budgets and overhead. Customers use Micro SaaS solutions on a monthly or yearly subscription basis. Micro SaaS projects target a small niche of the consumer market.

Software engineer hourly rates in 2021 (based on experience and location).png
November 22, 2021

Software engineer hourly rates in 2021 (based on experience and location)

Region influences salary more than any other factor. Taxes rates, cost of living, and government benefit programs affect the rates software developers charge. Software developers in the USA  and Canada earn more than software developers in other countries.

The best programming languages for app development in 2022.png
November 15, 2021

The best programming languages for app development in 2022

Software developers usually have three main ways to create an app. They can choose to code a native app, a hybrid app or a progressive web app. Developers create native apps to function on one specific platform, usually either iOS or Android. They create these apps using Swift or Objective C for iOS. For Android they use C++, Kotlin or several other languages. 

Cross-platform mobile app development: Tools & frameworks for 2022.png
November 09, 2021

Cross-platform mobile app development: Tools & frameworks for 2022

The cross-platform development project aims to create apps compatible with several operating systems. Cross-platform apps work on iOS, Android, and Windows. Cross-platform apps look and feel like apps developed specifically for the operating system.

App development cost breakdown in 2022.png
November 08, 2021

App development cost breakdown in 2022

Your business needs an app, but you aren’t sure about the cost of creating an app. Without some figures, you can’t even begin to estimate the potential budget, so let’s get you sorted with the information you need to make your app a reality.

unnamed.png
November 04, 2021

Web app development: a detailed guide

The best web apps give a responsive and engaging user experience through a browser instead of a single application. Think of web app development as a super-charged website. Web apps have many features of mobile apps coded for iOS or Android without the need to code for specific platforms. Developers create web apps using HTML, javascript, Python and CSS.

15 useful web app development tools for 2021.png
October 29, 2021

15 useful web app development tools for 2022

Web development vs app development: Choose the best for your business.png
October 19, 2021

Web development vs app development: Choose the best for your business

Outsource web development in 2021 and beyond: benefits & tips.png
October 15, 2021

Outsource web development in 2021 and beyond: benefits & tips

8 IT outsourcing trends in 2022.png
October 11, 2021

8 IT outsourcing trends in 2022

More and more firms choose to outsource their IT operations and functions. IT outsourcing grows each year. The Gartner report announced that firms spent $3.8 billion dollars on IT outsourcing in 2019. They expect that the trend will continue. Companies aiming for digital transformation need partners and tools. They need tools that they cannot build in-house with speed and accuracy. 

In-house development vs outsourcing software development.png
October 01, 2021

In-house development vs outsourcing software development

Every business starting software development must ask themselves what will serve them better, in-house or outsourcing? There is not a simple answer to the question. Making the choice to develop in-house or to outsource will have long-term consequences.

16 Software development project ideas.png
September 17, 2021

16 Software development project ideas

Every startup needs a great idea. Something unique and compelling. Startup businesses succeed when they find a customer need that they can fulfill. Startup businesses and independent software developers constantly search for just such needs.

Software development budget estimation.png
September 16, 2021

Software development budget estimation

An unlimited budget would make many teams very happy. But that approach has pitfalls. If the team works without much oversight or customer input, they may waste money. They might create features that the customers won’t use.

What are the differences between Agile and Waterfall?.png
September 07, 2021

What are the differences between Agile and Waterfall?

These days, most software development teams choose Agile methodology to organize their work. The Agile vs. Waterfall debate still rages, though. Many people question whether Agile works better than Waterfall in all circumstances. Does Agile deliver great ROI? Does Agile help teams work faster? Let’s take a close look at both Agile and Waterfall. We will examine the merits and drawbacks of each approach.

unnamed.png
September 06, 2021

Converting Story Points to Hours: Why Doesn't It Work?

In traditional software development, teams would describe the amount of work they had in hours. But Agile software development teams have a better way. Agile teams use Story Points to estimate the work they have ahead of them. Let’s take a closer look at Story Points and hours, and examine the benefits of Story Points.

Scrum vs. Extreme Programming (XP): What's the difference?.png
September 02, 2021

Scrum vs. Extreme Programming (XP): What's the difference?

We've covered the Software Development Life Cycle (SDLC) and the Agile development framework. Now it's time to look at different methodologies and approaches to their implementation. There are several, but we'll focus in this article on just two of them, Scrum and Extreme Programming (XP). We'll look at the differences between them and how they can even be used together for even better results.

The Scrum Sprint cycle explained.png
September 01, 2021

The Scrum Sprint cycle explained

Agile Scrum teams break down large development projects into small bursts of activity, called Sprints. A Sprint in Agile is a short, time-boxed period where a software development team completes work. They choose which items and fixes they will tackle in Sprint Planning Meetings. The Sprint cycle sits at the very center of Agile methodology. 

Use Cases vs. User Stories: relationships and differences.png
August 12, 2021

Use Cases vs. User Stories: relationships and differences

Product Backlog prioritization techniques & tips.png
July 27, 2021

Product Backlog prioritization techniques & tips

Software development project management guide.jpeg
July 26, 2021

Software development project management guide