🌦 Weather Search Application

A full-stack Weather Search Application built using Java Spring Boot that allows users to search for current weather information by city name.
The application integrates with the OpenWeatherMap API, implements caching for performance, and provides a simple web-based UI to display weather details.

🚀 Features

• Search current weather by city name
• REST ful backend API built with Spring Boot
• Integration with OpenWeatherMap external API for realtime weather update
• In-memory caching for faster repeated requests Using HashMap
• Proper handling of error scenarios (invalid city, API failure, etc.)
• Simple and clean UI using HTML, CSS, and JavaScript
• Display of detailed weather attributes
• Option to view raw API response get from OpenWeatherMap

---

🛠 Tech Stack

Backend

• Java 17+
• Spring Boot
• Spring Web (REST APIs)
• RestTemplate
• Jackson (JsonNode)
• Lombok
• Maven

Frontend

• HTML
• CSS
• JavaScript (Fetch API)

---

▶️ How to Run the Application Locally

✅ Prerequisites

Make sure the following are installed on your system:

• Java 17 or higher
• Maven
• Internet connection (to access OpenWeather API)

You can verify installation using:

java -version
mvn -version

---

1️⃣ Clone the Repository

git clone https://github.com/Shevadesuyash/weather-search-app-Fin-Factor.git
cd weather-search-app

---

2️⃣ Configure OpenWeather API Key

Open the file:

src/main/resources/application.yaml

Update the API key value:

weather:
  api:
    base-url: http://api.openweathermap.org/data/2.5/weather
    key: YOUR_OPENWEATHER_API_KEY
    units: metric

🔑 You can generate a free API key from: https://openweathermap.org/

---

3️⃣ Build and Run the Application

Run the following command from the project root directory:

mvn spring-boot:run

Spring Boot will start the application on port 8080.

---

4️⃣ Access the Application

• Web UI Open a browser and go to:

  http://localhost:8080
  

• Backend API (Direct Test)

  http://localhost:8080/api/weather?city=Pune
  

---

Response:

• Returns current weather details for the given city
• Includes temperature, humidity, wind speed, cloudiness, visibility, and raw API response

---

🐳 Run the Application Using Docker

The application is available as a Docker image on Docker Hub.

📦 Docker Image

suyash30/weather-search-app:0.1

---

1️⃣ Prerequisites

• Docker installed on your system
• Internet connection (to access OpenWeather API)

Verify Docker installation:

docker --version

---

2️⃣ Pull the Docker Image

docker pull suyash30/weather-search-app:0.1

---

3️⃣ Run the Docker Container

Replace YOUR_OPENWEATHER_API_KEY with your actual API key.

docker run -p 8080:8080 -e WEATHER_API_KEY=YOUR_OPENWEATHER_API_KEY suyash30/weather-search-app:0.1

---

4️⃣ Access the Application

• Web UI

  http://localhost:8080
  

• Backend API

  http://localhost:8080/api/weather?city=Pune
  

---

5️⃣ Stop the Container

Press:

Ctrl + C

or run:

docker ps
docker stop <container_id>

---

✔ Notes

• No local Java or Maven setup is required when using Docker
• The application runs entirely inside the container

---