react-native-http-server
** Note: This is an experimental library and needs a bit of love if you'd like to take it to production. **
HTTP Server for React Native
Android only for now.
Built on top of the NanoHttpd library: https://github.com/NanoHttpd/nanohttpd
Install
npm install --save react-native-http-server
Automatically link
With React Native 0.27+
react-native link react-native-http-server
With older versions of React Native
You need rnpm
(npm install -g rnpm
)
rnpm link react-native-http-server
Manually link
- in
android/app/build.gradle
:
dependencies {
...
compile "com.facebook.react:react-native:+" // From node_modules
+ compile project(':react-native-http-server')
}
- in
android/settings.gradle
:
...
include ':app'
+ include ':react-native-http-server'
+ project(':react-native-http-server').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-http-server/android')
With React Native 0.29+
- in
MainApplication.java
:
+ import com.strainy.RNHttpServer.RNHttpServer;
public class MainApplication extends Application implements ReactApplication {
//......
@Override
protected List<ReactPackage> getPackages() {
return Arrays.<ReactPackage>asList(
+ new RNHttpServer(),
new MainReactPackage()
);
}
......
}
With older versions of React Native:
- in
MainActivity.java
:
+ import com.strainy.RNHttpServer.RNHttpServer;
public class MainActivity extends ReactActivity {
......
@Override
protected List<ReactPackage> getPackages() {
return Arrays.<ReactPackage>asList(
+ new RNHttpServer(),
new MainReactPackage()
);
}
}
Release Notes
See CHANGELOG.md
Example
First import/require react-native-http-server:
var httpServer = require('react-native-http-server');
Initalise the server in the componentWillMount
lifecycle method. When initalising, you'll provide an options object (only the port
property is accepted for now) and a callback where requests will be captured and responses returned.
componentWillMount(){
var options = {
port: 1234, // note that 80 is reserved on Android - an exception will be thrown
};
// initalise the server (now accessible via localhost:1234)
httpServer.create(options, function(request, send){
// interpret the url
let url = request.url.split('/');
let ext = url[1];
let data = JSON.stringify({data: "hello world!", extension: ext});
//Build our response object (you can specify status, mime_type (type), data, and response headers)
let res = {};
res.status = "OK";
res.type = "application/json";
res.data = data;
res.headers = {
"Access-Control-Allow-Credentials": "true",
"Access-Control-Allow-Headers": "Authorization, Content-Type, Accept, Origin, User-Agent, Cache-Control, Keep-Alive, If-Modified-Since, If-None-Match",
"Access-Control-Allow-Methods": "GET, HEAD",
"Access-Control-Allow-Origin": "*",
"Access-Control-Expose-Headers": "Content-Type, Cache-Control, ETag, Expires, Last-Modified, Content-Length",
"Access-Control-Max-Age": "3000",
"Cache-Control": "max-age=300",
"Connection": "keep-alive",
"Content-Encoding": "gzip",
"Content-Length": data.length.toString(),
"Date": (new Date()).toUTCString(),
"Last-Modified": (new Date()).toUTCString(),
"Server": "Fastly",
"Vary": "Accept-Encoding"
};
send(res);
});
}
Finally, ensure that you disable the server when your component is being unmounted.
componentWillUnmount() {
httpServer.stop();
}