import 'dart:async'; import 'dart:convert'; import 'dart:io'; import 'package:flutter/cupertino.dart'; import 'package:flutter_gen/gen_l10n/app_localizations.dart'; import 'package:cached_network_image/cached_network_image.dart'; import 'package:flutter/material.dart'; import 'package:font_awesome_flutter/font_awesome_flutter.dart'; import 'package:image/image.dart'; import 'package:InvenTree/widget/dialogs.dart'; import 'package:path/path.dart' as path; import 'package:http/http.dart' as http; import 'package:shared_preferences/shared_preferences.dart'; /** * InvenTree API - Access to the InvenTree REST interface. * * InvenTree implements token-based authentication, which is * initialised using a username:password combination. */ class InvenTreeAPI { // Minimum supported InvenTree server version is static const List MIN_SUPPORTED_VERSION = [0, 1, 5]; String get _requiredVersionString => "${MIN_SUPPORTED_VERSION[0]}.${MIN_SUPPORTED_VERSION[1]}.${MIN_SUPPORTED_VERSION[2]}"; bool _checkServerVersion(String version) { // Provided version string should be of the format "x.y.z [...]" List versionSplit = version.split(' ').first.split('.'); // Extract the version number .. from the string if (versionSplit.length != 3) { return false; } // Cast the server version to an explicit integer int server_version_code = 0; print("server version: ${version}"); server_version_code += (int.tryParse(versionSplit[0]) ?? 0) * 100 * 100; server_version_code += (int.tryParse(versionSplit[1]) ?? 0) * 100; server_version_code += (int.tryParse(versionSplit[2])); print("server version code: ${server_version_code}"); int required_version_code = 0; required_version_code += MIN_SUPPORTED_VERSION[0] * 100 * 100; required_version_code += MIN_SUPPORTED_VERSION[1] * 100; required_version_code += MIN_SUPPORTED_VERSION[2]; print("required version code: ${required_version_code}"); return server_version_code >= required_version_code; } // Endpoint for requesting an API token static const _URL_GET_TOKEN = "user/token/"; static const _URL_GET_VERSION = ""; Future showServerError(BuildContext context, String description) async { showErrorDialog( context, I18N.of(context).serverError, description, icon: FontAwesomeIcons.server ); } // Base URL for InvenTree API e.g. http://192.168.120.10:8000 String _BASE_URL = ""; // Accessors for various url endpoints String get baseUrl { String url = _BASE_URL; if (!url.endsWith("/")) { url += "/"; } return url; } String _makeUrl(String url) { if (url.startsWith('/')) { url = url.substring(1, url.length); } url = url.replaceAll('//', '/'); return baseUrl + url; } String get apiUrl => _makeUrl("/api/"); String get imageUrl => _makeUrl("/image/"); String makeApiUrl(String endpoint) => _makeUrl("/api/" + endpoint); String makeUrl(String endpoint) => _makeUrl(endpoint); String _username = ""; String _password = ""; // Authentication token (initially empty, must be requested) String _token = ""; bool isConnected() => _token.isNotEmpty; /* * Check server connection and display messages if not connected. * Useful as a precursor check before performing operations. */ bool checkConnection(BuildContext context) { // Firstly, is the server connected? if (!isConnected()) { showDialog( context: context, child: new SimpleDialog( title: new Text("Not Connected"), children: [ ListTile( title: Text("Server not connected"), ) ] ) ); return false; } // Finally return true; } // Server instance information String instance = ''; // Server version information String _version = ''; // Getter for server version information String get version => _version; // Connection status flag - set once connection has been validated bool _connected = false; bool get connected { return _connected && baseUrl.isNotEmpty && _token.isNotEmpty; } // Ensure we only ever create a single instance of the API class static final InvenTreeAPI _api = new InvenTreeAPI._internal(); factory InvenTreeAPI() { return _api; } InvenTreeAPI._internal(); Future connect(BuildContext context) async { var prefs = await SharedPreferences.getInstance(); String server = prefs.getString("server"); String username = prefs.getString("username"); String password = prefs.getString("password"); return connectToServer(context, server, username, password); } Future connectToServer(BuildContext context, String address, String username, String password) async { /* Address is the base address for the InvenTree server, * e.g. http://127.0.0.1:8000 */ String errorMessage = ""; address = address.trim(); username = username.trim(); if (address.isEmpty || username.isEmpty || password.isEmpty) { await showErrorDialog( context, I18N.of(context).error, "Incomplete server details", icon: FontAwesomeIcons.server ); return false; } if (!address.endsWith('/')) { address = address + '/'; } // TODO - Better URL validation /* * - If not a valid URL, return error * - If no port supplied, append a default port */ _BASE_URL = address; _username = username; _password = password; _connected = false; print("Connecting to " + apiUrl + " -> " + username + ":" + password); var response = await get("").timeout(Duration(seconds: 10)).catchError((error) { if (error is SocketException) { errorMessage = "Could not connect to server"; return null; } else if (error is TimeoutException) { errorMessage = "Server timeout"; return null; } else { // Unknown error type - re-throw the error and Sentry will catch it throw error; } }); if (response == null) { // Null (or error) response: Show dialog and exit await showServerError(context, errorMessage); return false; } if (response.statusCode != 200) { // Any status code other than 200! // TODO: Interpret the error codes and show custom message? await showServerError(context, "Invalid response code: ${response.statusCode.toString()}"); return false; } var data = json.decode(response.body); print("Response from server: $data"); // We expect certain response from the server if (!data.containsKey("server") || !data.containsKey("version")) { await showServerError(context, "Server response missing required fields"); return false; } print("Server: " + data["server"]); print("Version: " + data["version"]); _version = data["version"]; if (!_checkServerVersion(_version)) { await showServerError(context, "Server version is too old.\n\nServer Version: ${_version}\n\nRequired version: ${_requiredVersionString}"); return false; } // Record the instance name of the server instance = data['instance'] ?? ''; // Request token from the server if we do not already have one if (false && _token.isNotEmpty) { print("Already have token - $_token"); return true; } // Clear the existing token value _token = ""; print("Requesting token from server"); response = await get(_URL_GET_TOKEN).timeout(Duration(seconds: 10)).catchError((error) { print("Error requesting token:"); print(error); return null; }); if (response == null) { await showServerError(context, "Error requesting access token"); return false; } if (response.statusCode != 200) { await showServerError(context, "Invalid status code: ${response.statusCode.toString()}"); return false; } else { var data = json.decode(response.body); if (!data.containsKey("token")) { await showServerError(context, "No token provided in response"); return false; } // Return the received token _token = data["token"]; print("Received token - $_token"); _connected = true; return true; }; } // Perform a PATCH request Future patch(String url, {Map body}) async { var _url = makeApiUrl(url); var _headers = defaultHeaders(); var _body = Map(); // Copy across provided data body.forEach((K, V) => _body[K] = V); print("PATCH: " + _url); return http.patch(_url, headers: _headers, body: _body, ); } /* * Upload a file to the given URL */ Future uploadFile(String url, File f, {String name = "attachment", Map fields}) async { var _url = makeApiUrl(url); var request = http.MultipartRequest('POST', Uri.parse(_url)); request.headers.addAll(defaultHeaders()); fields.forEach((String key, String value) { request.fields[key] = value; }); var _file = await http.MultipartFile.fromPath(name, f.path); request.files.add(_file); var response = await request.send(); return response; } // Perform a POST request Future post(String url, {Map body}) async { var _url = makeApiUrl(url); var _headers = jsonHeaders(); print("POST: ${_url} -> ${body.toString()}"); var data = jsonEncode(body); return http.post(_url, headers: _headers, body: data, ); } // Perform a GET request Future get(String url, {Map params}) async { var _url = makeApiUrl(url); var _headers = defaultHeaders(); // If query parameters are supplied, form a query string if (params != null && params.isNotEmpty) { String query = '?'; params.forEach((K, V) => query += K + '=' + V + '&'); _url += query; } // Remove extraneous character if present if (_url.endsWith('&')) { _url = _url.substring(0, _url.length - 1); } print("GET: " + _url); return http.get(_url, headers: _headers); } Map defaultHeaders() { var headers = Map(); headers[HttpHeaders.authorizationHeader] = _authorizationHeader(); return headers; } Map jsonHeaders() { var headers = defaultHeaders(); headers['Content-Type'] = 'application/json'; return headers; } String _authorizationHeader() { if (_token.isNotEmpty) { return "Token $_token"; } else { return "Basic " + base64Encode(utf8.encode('$_username:$_password')); } } static String get staticImage => "/static/img/blank_image.png"; static String get staticThumb => "/static/img/blank_image.thumbnail.png"; /** * Load image from the InvenTree server, * or from local cache (if it has been cached!) */ CachedNetworkImage getImage(String imageUrl, {double height, double width}) { if (imageUrl.isEmpty) { imageUrl = staticImage; } String url = makeUrl(imageUrl); return new CachedNetworkImage( imageUrl: url, placeholder: (context, url) => CircularProgressIndicator(), errorWidget: (context, url, error) => Icon(FontAwesomeIcons.exclamation), httpHeaders: defaultHeaders(), height: height, width: width, ); } }