- \n
- Serverless<\/li>\n
- Highly secure<\/li>\n
- Offers minimal setup<\/li>\n
- Provides three-way binding via angular fire<\/li>\n
- Easily access data, authentication, and more<\/li>\n
- Offers JSON storage that means no barrier between data and objects<\/li>\n
- Has a good storage potential<\/li>\n<\/ul>\n
Just like any other storage solution firebase also have some advantages i.e.<\/p>\n
- \n
- Limited querying and indexing support<\/li>\n
- No support for aggregation and map-reduce functionality<\/li>\n<\/ul>\n
1.1 Setting up Node.js<\/h3>\n
To set up Node.js<\/strong> on windows you will need to download the installer from this<\/a> link. Click on the installer (also include the NPM package manager) for your platform and run the installer to start with the Node.js setup wizard. Follow the wizard steps and click on Finish when it is done. If everything goes well you can navigate to the command prompt to verify if the installation was successful as shown in Fig. 1.<\/p>\n
\n![\"Firebase](\"https:\/\/www.javacodegeeks.com\/wp-content\/uploads\/2021\/11\/node-npm-installation-img1.jpg\")
<\/a>Fig. 1: Verifying node and npm installation<\/figcaption><\/figure>\n<\/div>\n 2. Firebase Cloud Firestore using Node.js<\/h2>\n
To set up the application, we will need to navigate to a path where our project will reside. For programming stuff, I am using Visual Studio Code<\/a> as my preferred IDE. You’re free to choose the IDE of your choice.<\/p>\n
2.1 Setting up the Firebase project<\/h3>\n
To set up the project implementation we will need a firebase project with the real-time database enabled. Once the project is created copy the firebase configuration which will be used in the
.env<\/code> properties. Refer to Section 2.2.2<\/a> for details. You can take a look at this<\/a> link to quickly create a firebase project in the google console.<\/p>\n2.2 Setting up the implementation<\/h3>\n
Let us write the different files which will be required for practical learning.<\/p>\n
2.2.1 Setting up dependencies<\/h4>\n
Navigate to the project directory and run
npm init -y<\/code> to create apackage.json<\/code> file. This file<\/a> holds the metadata relevant to the project and is used for managing the project dependencies, script, version, etc. Add the following code to the file wherein we will specify the required dependencies.<\/p>\npackage.json<\/em><\/span><\/p>\n
{\n \"name\": \"node-firebase\",\n \"version\": \"1.0.0\",\n \"description\": \"\",\n \"main\": \"index.js\",\n \"scripts\": {\n \"test\": \"echo \\\"Error: no test specified\\\" && exit 1\",\n \"start\": \"nodemon index.js\"\n },\n \"keywords\": [],\n \"author\": \"\",\n \"license\": \"ISC\",\n \"dependencies\": {\n \"body-parser\": \"^1.19.0\",\n \"cors\": \"^2.8.5\",\n \"dotenv\": \"^10.0.0\",\n \"express\": \"^4.17.1\",\n \"firebase\": \"^8.0.1\"\n },\n \"devDependencies\": {\n \"nodemon\": \"^2.0.15\"\n }\n}\n<\/pre>\nTo download the dependencies navigate to the directory path containing the file and use the
npm install<\/code> command. If everything goes well the dependencies will be loaded inside thenode_modules<\/code> folder and you are good to go with the further steps.<\/p>\n<\/a>2.2.2 Creating an environment file<\/h4>\n
Add the following code to the environment file. The file will be responsible to have the configuration variables spread across the application for further use.
<\/div> <\/div><\/p>\n.env<\/em><\/span><\/p>\n
#express server configuration\nPORT=3000\nHOST=localhost\nHOST_URL=http:\/\/localhost:3001\n\n#firebase configuration\nAPI_KEY=your_api_key\nAUTH_DOMAIN=app_auth_domain\nDATABASE_URL=app_realtime_database_url\nPROJECT_ID=app_id\nSTORAGE_BUCKET=app_storage_bucket\nMESSAGING_SENDER_ID=messaging_sender_id\nAPP_ID=app_id\n<\/pre>\n
2.2.3 Creating configuration file<\/h4>\n
Add the following code to the configuration file. The file will be responsible to import the environment variables from the
.env<\/code> file and perform the initialization assertions. The assertions to helps to avoid the common failures post the application startup.<\/p>\nconfig.js<\/em><\/span><\/p>\n
const dotenv = require(\"dotenv\");\nconst assert = require(\"assert\");\n\ndotenv.config();\n\nconst {\n PORT,\n HOST,\n HOST_URL,\n API_KEY,\n AUTH_DOMAIN,\n DATABASE_URL,\n PROJECT_ID,\n STORAGE_BUCKET,\n MESSAGING_SENDER_ID,\n APP_ID\n} = process.env;\n\n\/\/ adding init assertions\nassert(PORT, \"Application port is required\");\nassert(HOST_URL, \"Service endpoint is required\");\nassert(DATABASE_URL, \"Firebase database endpoint is required\");\nassert(PROJECT_ID, \"Firebase project id is required\");\nassert(APP_ID, \"Firebase app id is required\");\n\nmodule.exports = {\n port: PORT,\n host: HOST,\n url: HOST_URL,\n firebaseConfig: {\n apiKey: API_KEY,\n authDomain: AUTH_DOMAIN,\n databaseURL: DATABASE_URL,\n projectId: PROJECT_ID,\n storageBucket: STORAGE_BUCKET,\n messagingSenderId: MESSAGING_SENDER_ID,\n appId: APP_ID\n }\n};\n<\/pre>\n2.2.4 Creating database configuration<\/h4>\n
Add the following code to the database configuration file. The file will be responsible to initialize the Firebase configuration required for this application.<\/p>\n
db.js<\/em><\/span><\/p>\n
const firebase = require(\"firebase\");\nconst config = require(\".\/config\");\n\nconst db = firebase.initializeApp(config.firebaseConfig);\n\nmodule.exports = db;\n<\/pre>\n
2.2.5 Creating a model class<\/h4>\n
Add the following code to the model class which will be responsible to map the data to\/from the Firebase Firestore collection.<\/p>\n
employee.js<\/em><\/span><\/p>\n
class Employee {\n constructor(id, fullName, age, contact, department) {\n this.id = id; \/\/ represents the id generated by the firestore\n this.fullName = fullName;\n this.age = age;\n this.contact = contact;\n this.department = department;\n }\n}\n\nmodule.exports = Employee;\n<\/pre>\n2.2.6 Creating a controller class<\/h4>\n
Add the following code to the controller class which will be responsible to get the data from the client and interact with the Firebase Firestore collection. The class consists of different methods to save a new employee, update\/delete\/get an employee by id, and get all employees.<\/p>\n
employeeController.js<\/em><\/span><\/p>\n
const firebase = require(\"..\/db\");\nconst Employee = require(\"..\/models\/employee\");\nconst fireStore = firebase.firestore();\n\n\/\/ performing crud operations in the firebase firestore\n\/\/ add\n\/\/ get all\n\/\/ get\n\/\/ update\n\/\/ delete\n\nconst addEmployee = async (req, res, next) => {\n try {\n console.log(\"Adding new employee\");\n const data = req.body;\n await fireStore.collection(\"employees\").doc().set(data);\n res.status(201).json({ message: \"Record saved successfully\" });\n } catch (error) {\n res.status(400).json({ message: error.message });\n }\n};\n\nconst getAllEmployees = async (req, res, next) => {\n try {\n console.log(\"Getting all employees\");\n const employees = await fireStore.collection(\"employees\");\n const data = await employees.get();\n const arr = [];\n if (data.empty) {\n res.status(200).json({ message: \"No records found\" });\n } else {\n let total = 0;\n data.forEach((item) => {\n const employee = new Employee(\n item.id,\n item.data().fullName,\n item.data().age,\n item.data().contact,\n item.data().department\n );\n arr.push(employee);\n total = total + 1;\n });\n res.status(200).json({\n listing: arr,\n count: total\n });\n }\n } catch (error) {\n res.status(400).json({ message: error.message });\n }\n};\n\nconst getEmployee = async (req, res, next) => {\n try {\n const id = req.params.id;\n console.log(\"Getting employee= %s\", id);\n const employee = await fireStore.collection(\"employees\").doc(id);\n const data = await employee.get();\n if (!data.exists) {\n res.status(404).json({ message: \"Record not found\" });\n } else {\n res.status(200).json(data.data());\n }\n } catch (error) {\n res.status(400).json({ message: error.message });\n }\n};\n\nconst updateEmployee = async (req, res, next) => {\n try {\n const id = req.params.id;\n console.log(\"Updating employee= %s\", id);\n const data = req.body;\n const employee = await fireStore.collection(\"employees\").doc(id);\n await employee.update(data);\n res.status(204).json({ message: \"Record updated successfully\" });\n } catch (error) {\n res.status(400).json({ message: error.message });\n }\n};\n\nconst deleteEmployee = async (req, res, next) => {\n try {\n const id = req.params.id;\n console.log(\"Deleting employee= %s\", id);\n await fireStore.collection(\"employees\").doc(id).delete();\n res.status(204).json({ message: \"Record deleted successfully\" });\n } catch (error) {\n res.status(400).json({ message: error.message });\n }\n};\n\n\/\/ todo - add delete all employees\n\nmodule.exports = {\n addEmployee,\n getAllEmployees,\n getEmployee,\n updateEmployee,\n deleteEmployee\n};\n<\/pre>\n2.2.7 Creating a router class<\/h4>\n
Add the following code to the router class which will be responsible to map the incoming request from the client with the appropriate controller method.<\/p>\n
employeeController.js<\/em><\/span><\/p>\n
const express = require(\"express\");\nconst {\n addEmployee,\n getAllEmployees,\n getEmployee,\n updateEmployee,\n deleteEmployee\n} = require(\"..\/controllers\/employeeController\");\n\nconst router = express.Router();\n\n\/\/ http:\/\/localhost:3000\/api\/employee\nrouter.post(\"\/employee\", addEmployee);\n\n\/\/ http:\/\/localhost:3000\/api\/employees\nrouter.get(\"\/employees\", getAllEmployees);\n\n\/\/ http:\/\/localhost:3000\/api\/employee\/xxxx_employee_id\nrouter.get(\"\/employee\/:id\", getEmployee);\n\n\/\/ http:\/\/localhost:3000\/api\/employee\/xxxx_employee_id\nrouter.put(\"\/employee\/:id\", updateEmployee);\n\n\/\/ http:\/\/localhost:3000\/api\/employee\/xxxx_employee_id\nrouter.delete(\"\/employee\/:id\", deleteEmployee);\n\nmodule.exports = {\n routes: router\n};\n<\/pre>\n2.2.8 Creating an index file<\/h4>\n
Add the following code to the index file which will be responsible for the application startup and act as a welcome point for the application.<\/p>\n
index.js<\/em><\/span><\/p>\n
const express = require(\"express\");\nconst cors = require(\"cors\");\nconst bodyParser = require(\"body-parser\");\nconst config = require(\".\/config\");\nconst employeeRoutes = require(\".\/routes\/employeeRoutes\");\n\nconst app = express();\n\napp.use(express.json());\napp.use(cors());\napp.use(bodyParser.json());\n\napp.use(\"\/api\", employeeRoutes.routes);\n\napp.listen(config.port, () => {\n console.log(\"Service endpoint= %s\", config.url);\n});\n<\/pre>\n3. Run the Application<\/h2>\n
To run the application navigate to the project directory and enter the following command as shown in Fig. 2. If everything goes well the application will be started successfully on a port number read from the
.env<\/code> file. In this case, the application will be started successfully on a port number \u20133001<\/code>.<\/p>\n\n![\"\"](\"https:\/\/www.javacodegeeks.com\/wp-content\/uploads\/2021\/11\/project-run-guide.jpg\")
<\/a>Fig. 2: Starting the application<\/figcaption><\/figure>\n<\/div>\n 4. Demo<\/h2>\n
You are free to use postman<\/a> or any other tool of your choice to make the HTTP request to the application endpoints.<\/p>\n
Endpoints<\/em><\/span><\/p>\n
\/\/ add an employee\n\/\/ http post\nhttp:\/\/localhost:3000\/api\/employee\n\n\/\/ get all employees\n\/\/ http get\nhttp:\/\/localhost:3000\/api\/employees\n\n\/\/ get an employee\n\/\/ http get\nhttp:\/\/localhost:3000\/api\/employee\/xxxx_employee_id\n\n\/\/ update an employee\n\/\/ http put\nhttp:\/\/localhost:3000\/api\/employee\/xxxx_employee_id\n\n\/\/ delete an employee\n\/\/ http delete\nhttp:\/\/localhost:3000\/api\/employee\/xxxx_employee_id\n<\/pre>\n
That is all for this tutorial and I hope the article served you with whatever you were looking for. Happy Learning and do not forget to share!<\/p>\n
5. Summary<\/h2>\n
In this tutorial, we learned about integrating Firebase in the nodejs application. Firebase offers a real-time database that offers the data to be stored in a JSON format and offers a fast way to implement the BaaS solution. You can download the source code and the postman collection from the Downloads<\/a> section.<\/p>\n
<\/a>6. Download the Project<\/h2>\n
This was a tutorial to integrate Firebase in the nodejs application.<\/p>\n