Socket Java API Overview
This is a Preview release of the Socket API. As a result, the API is subject to change and the service itself is currently not covered by any SLA or deprecation policy. These characteristics will be evaluated as the API and service moves towards General Availability, but developers should take this into consideration when using the Preview release of Socket API.App Engine supports regular outbound Java sockets such as java.net.Socket and java.net.DatagramSocket. There is currently no support for sockets via java.nio.SocketChannel or other
java.nioclasses. The Sockets API allows client code to call get/set options against sockets. (Previously, calls raised Not Implemented exceptions.)
The currently supported options are:
Limitations and restrictions
App Engine supports sockets without requiring you to import any special App Engine libraries or add any special App Engine code. However, there are certain limitations and behaviors you need to be aware of when using sockets:
- Sockets are available only for paid apps.
- You cannot create a listen socket; you can only create outbound sockets.
java.net.URLis still configured to use the URL Fetch API; there is currently no way around this.
- Most classes in
- You can only use TCP or UDP; arbitrary protocols are not allowed.
- You cannot bind to specific IP addresses or ports.
- Port 25 (SMTP) is blocked; you can still use authenticated SMTP on the submission port 587.
- Private, broadcast, multicast, and Google IP ranges (except those
whitelisted below), are blocked:
- Google Public DNS:
- Gmail SMTPS:
smtp.gmail.comport 465 and 587
- Gmail POP3S:
- Gmail IMAPS:
- Google Public DNS:
- Socket descriptors are associated with the App Engine app that created them and are non-transferable (cannot be used by other apps).
- Sockets may be reclaimed after 2 minutes of inactivity; any socket operation keeps the socket alive for a further 2 minutes.
- You cannot
Selectbetween multiple available sockets because that requires
java.nio.SocketChannelwhich is not currently supported.)
Using sockets with the development server
You can run and test code using sockets on the development server, without using any special command line parameters.
App Engine sample using sockets
For a sample using sockets, see the socket demo app in the Google Cloud Platform GitHub.