我建议本文仅向尚未使用Retrofit 2的用户阅读。毕竟,在本文中,我将尽可能详细地描述所有内容,以使每个人都理解。
0.项目创建
这里的一切都尽可能简单,在Android Studio中创建一个新项目,然后选择Empty Activity。接下来,您需要选择一种编程语言,我们将使用Kotlin。
1.添加依赖项
现在我们需要添加所有必需的库,因此我们进入build.gradle并添加以下内容:
dependencies {
implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.squareup.retrofit2:converter-gson:2.5.0'
implementation 'com.squareup.picasso:picasso:2.71828'
//noinspection GradleCompatible
implementation 'com.android.support:design:28.0.0'
implementation 'com.github.d-max:spots-dialog:1.1@aar'
}
您可能已经注意到,这里我们添加了所有必要的库,包括Spots进度对话框。您可以在此处了解更多信息。然后在build.gradle(模块:应用程序)中,我们必须插入以下代码:
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
剩下的只是去清单并添加使用手机的权限
<uses-permission android:name="android.permission.INTERNET"/>
2.添加数据类
在进行第二点之前,我们需要找出从何处获取数据?解析将从这里开始。
太好了,然后复制此站点的内容并转到此处。在这里,我们从站点粘贴先前复制的文本,在单击树之后,我们得到一个列表,将其打开,现在我们看到有8个对象。如果有人不理解,那么我将向您显示一个屏幕:
您在右侧看到的是我们复制的文本,而右侧看到的是已处理的数据。
现在回到Android Studio,创建一个文件夹,命名为Model,在其中创建一个kotlin类,并从常规类中将其命名为Movie,对数据类进行转换,我们只在类之前添加数据,并用括号替换花括号,然后在括号中指出变量在网站上监视,这些变量必须是可为空的类型。
完整的代码
data class Movie(
var name: String? = null,
var realname: String? = null,
var team: String? = null,
var firstapperance: String? = null,
var createdby: String? = null,
var publisher: String? = null,
var imageurl: String? = null,
var bio: String? = null
)
如果您想知道为什么将该文件夹称为Model,那么我将告诉您:
Model是与应用程序数据关联的逻辑。换句话说,这些是POJO,即与API一起使用的类,数据库。
3.创建客户
接下来,我们创建Retrofit文件夹,并在该文件夹中创建一个对象并将其命名为RetrofitClient,然后创建Retrofit类型的Retrofit变量,之后我们创建一个函数并将其命名为getCleint(baseUrl:String),返回类型为Retrofit。在函数主体中,有必要检查改造是否为null,如果改造为null,则将Retrofit分配给retrofit.Builder()使用baseUrl参数附加baseUrl,然后将addconverterFactory方法与GsonConverterFactory.create()参数附加并使用build( ),并将改型返回到非零类型
完整的代码
import retrofit2.Retrofit
import retrofit2.converter.gson.GsonConverterFactory
object RetrofitClient {
private var retrofit: Retrofit? = null
fun getClient(baseUrl: String): Retrofit {
if (retrofit == null) {
retrofit = Retrofit.Builder()
.baseUrl(baseUrl)
.addConverterFactory(GsonConverterFactory.create())
.build()
}
return retrofit!!
}
}
Retrofit中的Builder是使用Builder接口和API来定义HTTP操作的URL端点定义的实例
4.使用界面
接口-创建抽象类所需。
在其中创建一个Interface包,我们将一个Interface命名为RetrofitServieces。在括号中创建一个Get请求,写引号,并用引号表示我们将从中解析数据的分支,这真是奇妙。但在此之前,这是值得一说的什么一个GET和POST请求是
GET -从一个特定的资源(网站)请求数据
POST -将数据发送到服务器进行进一步处理
好了,现在你需要创建一个getMovieList功能,它应该返回MutableList类型的呼叫和MutableList应电影类型
完整的代码
import com.example.retrofitmarvel.Model.Movie
import retrofit2.Call
import retrofit2.http.*
interface RetrofitServices {
@GET("marvel")
fun getMovieList(): Call<MutableList<Movie>>
}
5.常见
现在我们必须创建Common文件夹,在该文件夹中放置一个对象并将其命名为Common,创建一个变量,将其命名为BASE_URL,在其中我们必须放置用于解析数据的链接,但不要放置最后一个分支,因为它是从那里接收数据... 我们创建了retrofitServices变量,它具有一个get()方法,为它分配RetrofitClient,然后才将getClient方法与RetrofitClients :: class.java参数联网到RetrofitClient
完整的代码
import com.example.retrofitmarvel.Interface.RetrofitServices
import com.example.retrofitmarvel.Retrofit.RetrofitClient
object Common {
private val BASE_URL = "https://www.simplifiedcoding.net/demos/"
val retrofitService: RetrofitServices
get() = RetrofitClient.getClient(BASE_URL).create(RetrofitServices::class.java)
}
6.布局
转到activity_main.xml并在其中添加RecyclerView
XML格式
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<androidx.recyclerview.widget.RecyclerView
android:id="@+id/recyclerMovieList"
android:layout_width="0dp"
android:layout_height="0dp"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>
在布局文件夹中,在根元素中创建一个item_layout,指定CardView
item_layout
<androidx.cardview.widget.CardView
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:cardElevation="8dp"
android:layout_margin="8dp">
<androidx.constraintlayout.widget.ConstraintLayout
android:id="@+id/linearLayout"
android:layout_width="match_parent"
android:layout_height="167dp">
<ImageView
android:id="@+id/image_movie"
android:layout_width="0dp"
android:layout_height="100dp"
android:layout_marginEnd="8dp"
android:layout_marginRight="8dp"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toStartOf="@+id/txt_name"
app:layout_constraintHorizontal_bias="0.0"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent"
app:layout_constraintVertical_bias="0.238" />
<TextView
android:id="@+id/txt_name"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginStart="192dp"
android:layout_marginLeft="192dp"
android:layout_marginTop="16dp"
android:text="name"
android:textColor="@android:color/black"
android:textSize="20sp"
android:textStyle="bold"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent" />
<TextView
android:id="@+id/txt_team"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginStart="196dp"
android:layout_marginLeft="196dp"
android:layout_marginTop="8dp"
android:text="team"
android:textColor="@android:color/black"
android:textSize="16sp"
android:textStyle="normal"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@+id/txt_name" />
<TextView
android:id="@+id/txt_createdby"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginStart="184dp"
android:layout_marginLeft="184dp"
android:layout_marginTop="12dp"
android:text="createdby"
android:textColor="@android:color/black"
android:textSize="18sp"
android:textStyle="italic"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@+id/txt_team" />
</androidx.constraintlayout.widget.ConstraintLayout>
</androidx.cardview.widget.CardView>
7.转接器
现在,我们必须创建一个Adapter包,在其中放置一个类并将其命名为MyMovieAdapter
Adapter负责从数据集中检索数据并基于此数据创建View对象。
在MyMovieAdapter类中,我们创建仅在此类私有val movieList:Movie类型的MutableList中可用的变量,并指定返回值的类型,我们将使用MyMovieAdapter.MyViewHolder类型的RecyclerView.Adapter
实现方法,即onCreateViewHolder,getItemCount和onBindViewHolder
我们创建MyViewHolder类,在该类中指定itemView:View参数和返回类型RecyclerView.ViewHolder,并将变量放在此类的主体中,例如:
值图像:ImageView = itemView.image_movie image_movie是从item_layout绘制的
,因此我们为所有其余视图项目指定。
让我们用listItem:Movie参数创建一个绑定函数,在这里我们可以使视图项可点击,我想您可以做到。
接下来,我们重写getItemCount()以覆盖fun getItemCount()= movieList.size。这里的一切都很简单,我们创建了一个函数并返回movieList.size。太好了,剩下的就是处理onBindViewHolder和onCreateViewHolder
onCreateViewHolder-每当RecyclerView需要它时,都会创建一个新的ViewHolder对象。
onBindViewHolder-使用ViewHolder对象,并为视图组件中的相应行设置必要的数据
现在,我们将使用onCreateViewHolder返回类型MyViewHolder分析这种情况。
创建变量itemView,将其分配给LayoutInflater.from(parent.context).inflate(R.layout.item_layout,parent,false),然后返回带有itemView参数的MyViewHolder。现在转到主体中的onBindViewHolder,我们创建变量listItem:Movie并分配movieList [position]。接下来,我们将具有listItem参数的bind方法附加到holder'y。接下来,我们使用Picasso库。
Picasso.get()。将(movieList [position] .imageurl).in加载到(holder.image)。然后添加holder.txt_name.text = movieList [position] .name,这就是我们处理所有视图元素的方式
完整的代码
import android.content.Context
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import android.widget.ImageView
import android.widget.TextView
import android.widget.Toast
import androidx.recyclerview.widget.RecyclerView
import com.example.retrofitmarvel.Model.Movie
import com.example.retrofitmarvel.R
import com.squareup.picasso.Picasso
import kotlinx.android.synthetic.main.item_layout.view.*
class MyMovieAdapter(private val context: Context,private val movieList: MutableList<Movie>):RecyclerView.Adapter<MyMovieAdapter.MyViewHolder>() {
class MyViewHolder(itemView: View): RecyclerView.ViewHolder(itemView){
val image: ImageView = itemView.image_movie
val txt_name: TextView = itemView.txt_name
val txt_team: TextView = itemView.txt_team
val txt_createdby: TextView = itemView.txt_createdby
fun bind(listItem: Movie) {
image.setOnClickListener {
Toast.makeText(it.context, " ${itemView.image_movie}", Toast.LENGTH_SHORT)
.show()
}
itemView.setOnClickListener {
Toast.makeText(it.context, " ${itemView.txt_name.text}", Toast.LENGTH_SHORT).show()
}
}
}
override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): MyViewHolder {
val itemView = LayoutInflater.from(parent.context).inflate(R.layout.item_layout, parent, false)
return MyViewHolder(itemView)
}
override fun getItemCount() = movieList.size
override fun onBindViewHolder(holder: MyViewHolder, position: Int) {
val listItem = movieList[position]
holder.bind(listItem)
Picasso.get().load(movieList[position].imageurl).into(holder.image)
holder.txt_name.text = movieList[position].name
holder.txt_team.text = movieList[position].team
holder.txt_createdby.text = movieList[position].createdby
}
}
8. MainActivity
优秀的!只剩下一点点。首先进入MainActivity,我们将创建变量,并且为了不将其声明为null类型,我们将通过lateinit var mService:RetrofitServices对其进行声明,我们需要再创建3个变量,即:LinearLayoutManager,MyMovieAdapter,AlertDialog。您可以随便叫他们,没关系。在onCreate方法中,我们将Common.retrofitServices分配给RetrofitServices。在下一行,我们将setHasFixedSize(true)附加到recyclerView-借助此方法,我们可以优化列表,然后将LinearLayoutManager(this)分配给layoutManager。
布局经理-这是负责对用户不再可见的View组件进行定位的事情。此外,一切也很容易将layoutManager附加到我们的列表,并已经将layoutManager分配给我们。好的,现在可以使用SpotsDialog库。我们使用AlertDialog类型指定先前命名的变量,分配SpotsDialog,附加Builder方法,然后将setCancelablec方法和true参数附加到此,必须将setContext方法和this参数附加,并将build方法附加。
现在,我们必须在onCreate方法之外创建一个新函数,称为函数getAllMovieList。在此函数的主体中,我们必须指定我们的对话框并将其附加show()方法,
然后将getMovieList方法添加到mService .enqueue(对象:回调<MutableList> {)
现在我们需要实现方法,我们有两个onResponse和onFailure
以及onResponse中,即在此方法的主体中,我们分配给adapter'y
MyMovieAdapter(baseContext, response.body() as MutableList<Movie>)
此外,我们将notifyDataSetChanged()方法分配给adapter'y。在我们的列表中,我们附加了适配器并分配了适配器。然后将dismiss()方法分配给dialog。这意味着我们的对话框将在加载数据后消失。
完整的代码
import android.app.AlertDialog
import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import androidx.recyclerview.widget.LinearLayoutManager
import com.example.retrofitmarvel.Adapter.MyMovieAdapter
import com.example.retrofitmarvel.Common.Common
import com.example.retrofitmarvel.Interface.RetrofitServices
import com.example.retrofitmarvel.Model.Movie
import com.example.retrofitmarvel.R
import dmax.dialog.SpotsDialog
import kotlinx.android.synthetic.main.activity_main.*
import retrofit2.Call
import retrofit2.Callback
import retrofit2.Response
class MainActivity : AppCompatActivity() {
lateinit var mService: RetrofitServices
lateinit var layoutManager: LinearLayoutManager
lateinit var adapter: MyMovieAdapter
lateinit var dialog: AlertDialog
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
mService = Common.retrofitService
recyclerMovieList.setHasFixedSize(true)
layoutManager = LinearLayoutManager(this)
recyclerMovieList.layoutManager = layoutManager
dialog = SpotsDialog.Builder().setCancelable(true).setContext(this).build()
getAllMovieList()
}
private fun getAllMovieList() {
dialog.show()
mService.getMovieList().enqueue(object : Callback<MutableList<Movie>> {
override fun onFailure(call: Call<MutableList<Movie>>, t: Throwable) {
}
override fun onResponse(call: Call<MutableList<Movie>>, response: Response<MutableList<Movie>>) {
adapter = MyMovieAdapter(baseContext, response.body() as MutableList<Movie>)
adapter.notifyDataSetChanged()
recyclerMovieList.adapter = adapter
dialog.dismiss()
}
})
}
}
优秀的!在本文中,我们学习了如何使用Retrofit2并将其放入RecyclerView中。