Sunshine with Architecture Components (DEPRECATED)
This Sample is Deprecated
This sample is deprecated and is not actively maintained. For example, the WorkManager library is now the best practice solution for handling scheduled background work.
Instead, please refer to the following samples and training materials:
- Room with a View sample code
- Room with a View Codelab in Java
- Room with a View Codelab in Kotlin
- Architecture Components Samples
- Developing Android Apps with Kotlin online training course
About
This app is for the Build an App with Architecture Components Codelab.
Starting Classes
Below is a description of the different packages and classes in the starting app code.
data
package
Contains all classes related to local and network app data.
data.network
package
All classes related to fetching data from the network.
- The network fetching and parsing functions are all written for you.
- You will not modify the
NetworkUtils
,OpenWeatherJsonParser
andWeatherResponse
classes. WeatherNetworkDataSource
manages everything to do with the network. It's a singleton. It contains:scheduleRecurringFetchWeatherSync()
- Makes a repeatingJobService
usingFirebaseJobDispatcher
. This repeating job will eventually sync weather information in the background.startFetchWeatherService()
-IntentService
for doing an immediate fetch of weather data.fetchWeather()
- Actually gets weather forecast data. This method uses the JSON parsing classes and network classes to make the fetch. It currently doesn't do anything with the fetched weather data.
data.database
package
All classes related to caching the data locally (it's pretty empty right now).
WeatherEntry
- A simple Java object representing one day of weather.
ui
package
All activities and adapters - anything to do with display.
ui.detail package
DetailActivity
-Activity
for a single day of forecast.
ui.list package
MainActivty
-Activity
for a list ofWeatherEntry
forecasts.ForecastAdapter
-RecyclerView.Adapter
for displaying the list ofWeatherEntry
forecasts.
utilities
package
- You will not modify
SunshineDateUtils
orSunshineWeatherUtils
. SunshineDateUtils
- Utility methods for normalizing dates across time zones; this helps us to "round" to the nearest date, so that when you store a date in the database, it always refers to that date at 12:00am, GMT.SunshineWeatherUtils
- Utility methods related to displaying the weather, such as picking the right image resource to show a cloudy sky or rain.
AppExectuors class
This class provides a global executor pool. You can learn more about thread pools here. In short, this class provides an easy and efficient way to run code off of the main thread.
License
All image and audio files (including *.png, *.jpg, *.svg, *.mp3, *.wav and *.ogg) are licensed under the CC-BY-NC license. All other files are licensed under the Apache 2 license. See the LICENSE file for details. Copyright 2017 Google Inc. All rights reserved. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.