在我的第一篇文章中,我将解释如何解析ESPN API。 可以在http://developer.espn.com/docs上找到API文档。
首先,您需要请求一个API密钥,然后可以开始查询REST API以检索JSON响应。 在下面的示例中,我将简单地查询在英格兰英超联赛中踢球的“足球”运动。
通过阅读文档,这是我需要向其发送请求的URL(用[apiKey]替换为正确的值)。
http://api.espn.com/v1/sports/soccer/eng.1/athletes?apikey=[apiKey]
首先要记住的是,如果您想要的结果不止50个,则有一个offset值会迫使您进行多个查询,这是通过称为offset的参数进行设置的。 因此,例如,要从51-101获得结果,以下查询将这些结果拉回去。 我们稍后会再讨论,因为这可能会引起一些轻微的问题。
http://api.espn.com/v1/sports/soccer/eng.1/athletes?apikey=[apiKey]&offset=51
现在我已经有了完整的描述,我将开始代码,应该注意的是我正在使用GSON来解析JSON,因此您需要添加以下Maven依赖项。
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.2.2</version>
</dependency>
完成此操作后,您运行了maven:install以下载jar,可以开始查询。 从ESPN API下载JSON只需下面的代码
private static String readUrl(final String urlString) throws Exception {
BufferedReader reader = null;
try {
final URL url = new URL(urlString);
reader = new BufferedReader(new InputStreamReader(url.openStream()));
final StringBuffer buffer = new StringBuffer();
int read;
final char[] chars = new char[1024];
while ((read = reader.read(chars)) != -1) {
buffer.append(chars, 0, read);
}
return buffer.toString();
} finally {
if (reader != null) {
reader.close();
}
}
}
现在我们可以开始解析此JSON,因为生成的JSON具有很多冗余数据,所以我决定不将其解析为对象,而只是对其进行原始查询。
private static JsonArray getAthletesJsonArray(final int offset)
throws Exception {
final String json = readUrl(getUrl(offset));
final JsonArray sports = getSportsJsonArray(json);
final JsonElement league = sports.get(0);
return league.getAsJsonObject().get("leagues").getAsJsonArray().get(0)
.getAsJsonObject().get("athletes").getAsJsonArray();
}
private static JsonArray getSportsJsonArray(final String json) {
final JsonArray sports = new JsonParser().parse(json).getAsJsonObject()
.get("sports").getAsJsonArray();
return sports;
}
private static String getUrl(final int offset) {
return APIURL + APIKEY + "&offset=" + offset;
}
这将为我们提供一个JsonArray的运动员以及可以从中获取的相关数据。 值得注意的是,此处的响应因您的API配额(免费,合作伙伴,付费等)而异。 我将在此处http://developer.espn.com/docs/athletes#parameters离开相关的ESPN API页面。
现在,当我们有了所需的相关JsonArray时,我们可以循环遍历它以返回有关每个播放器的数据。
for (int offset = 1; offset < 650; offset = offset + 50) {
try {
final JsonArray athletes = getAthletesJsonArray(offset);
for (final JsonElement athlete : athletes) {
System.out.println(athlete.getAsJsonObject()
.get("fullName"));
}
Thread.sleep(100);
} catch (Exception e) {
e.printStackTrace();
}
}
应当指出,此代码看起来有些奇怪。 首先,睡眠的原因是因为API限制了您每秒可以调用它的次数,目前,由于我免费编写此代码,因此每3秒只能使用一次。 其次,它处于650循环的原因是与我在本文前面引用的偏移量有关。 这意味着您需要查询每50个播放器,这在计算上似乎有点昂贵,因为我认为仅返回602个播放器而不是承担接收12个RESTful调用的繁重工作就容易了。
然后,当我们将所有这些放在一起时,您将获得下面的课程,这将遍历每个给您名字的玩家。
package org.espn.app;
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.URL;
import com.google.gson.JsonArray;
import com.google.gson.JsonElement;
import com.google.gson.JsonParser;
/**
* @author David Gray
*
* This class is simply an example of how to parse the Json
* API for ESPN.
*/
public class EspnParser {
private static final String APIKEY = "apiKey";
private static final String APIURL = "http://api.espn.com/v1/sports/soccer/eng.1/athletes?apikey=";
/**
* @param arguments
* for main method.
*/
public static void main(final String[] args) {
for (int offset = 1; offset < 650; offset = offset + 50) {
try {
final JsonArray athletes = getAthletesJsonArray(offset);
for (final JsonElement athlete : athletes) {
System.out.println(athlete.getAsJsonObject()
.get("fullName"));
}
Thread.sleep(100);
} catch (Exception e) {
e.printStackTrace();
}
}
}
private static JsonArray getAthletesJsonArray(final int offset)
throws Exception {
final String json = readUrl(getUrl(offset));
final JsonArray sports = getSportsJsonArray(json);
final JsonElement league = sports.get(0);
return league.getAsJsonObject().get("leagues").getAsJsonArray().get(0)
.getAsJsonObject().get("athletes").getAsJsonArray();
}
private static JsonArray getSportsJsonArray(final String json) {
final JsonArray sports = new JsonParser().parse(json).getAsJsonObject()
.get("sports").getAsJsonArray();
return sports;
}
private static String getUrl(final int offset) {
return APIURL + APIKEY + "&offset=" + offset;
}
private static String readUrl(final String urlString) throws Exception {
BufferedReader reader = null;
try {
final URL url = new URL(urlString);
reader = new BufferedReader(new InputStreamReader(url.openStream()));
final StringBuffer buffer = new StringBuffer();
int read;
final char[] chars = new char[1024];
while ((read = reader.read(chars)) != -1) {
buffer.append(chars, 0, read);
}
return buffer.toString();
} finally {
if (reader != null) {
reader.close();
}
}
}
}
您可以在github https://github.com/david99world/EspnApiParsingExample上下载完整项目
翻译自: https://www.javacodegeeks.com/2013/06/parsing-espn-api-using-java-and-google-gson.html