使用Java和Google GSON解析ESPN API

在我的第一篇文章中，我将解释如何解析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上下载完整项目

参考：来自Code Mumble博客的JCG合作伙伴 David Gray 使用Java和Google GSON解析ESPN API 。