fcamussi / ml_searcher

Librería de Java para hacer búsquedas utilizando la API de Mercado Libre

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

ML Searcher

Librería de Java para hacer búsquedas utilizando la API de Mercado Libre

Documentación

La librería contiene dos clases principales, la clase MLSearcher para buscar artículos en Mercado Libre y la clase MLSite para obtener los sitios (paises) disponibles.

Los resultados de las búsquedas pueden filtrarse para que las palabras de las mismas estén contenidas en el título, la marca y el modelo del producto de la publicación, haciendo que las mismas sean mucho más precisas.

Clase MLSearcher

Métodos estáticos

static String stringListToString(List<String> stringList)

Convierte una lista de strings en una string

Parámetros: stringList - Lista de strings a convertir

Retorna: String

static List<String> stringToStringList(String string)

Convierte una string en una lista de strings

Parámetros: string - La string a convertir

Retorna: Lista de strings

Métodos

void setSiteId(String siteId)

Setea el id del sitio donde se hará la búsqueda: MLA, MLB, etc.

Parámetros: siteId - Id del sitio

void setAgent(String agent)

Setea el agente HTTP

Parámetros: agent - Nombre del agente HTTP. Por defecto es MLSearcher

void setWords(List<String> wordList) 	

Setea las palabras a buscar

Parámetros: wordList - Lista de palabras

void setMaxResultCount(int maxResultCount)

Setea la cantidad máxima de resultados que se exploran en la búsqueda

Parámetros: maxResultCount - Cantidad máxima de resultados. El valor por defecto es 1000, que es la cantidad máxima definida por ML

Throws: Exception - Si maxResultCount es mayor a 1000

void setFiltered(boolean filtered)

Setea si se hace un filtrado para que las palabras estén contenidas dentro del título + marca + modelo

Parámetros: filtered - true para filtrar, false para no filtrar. Por defecto es true

int getResultCount()

Consulta la cantidad de resultados que produce la búsqueda

Retorna: La cantidad de resultados

Throws: Exception - Si falla la consulta

void searchItems()

Realiza la búsqueda

Throws: Exception - Si falla la búsqueda o el id del sitio no fue especificado

List<Map<String,String>> getFoundItems()

Obtiene la lista de artículos encontrados

Retorna: Lista de artículos de tipo Map

Clase MLSites

Métodos

public void setAgent(String agent)

Setea el agente HTTP

Parámetros: agent - Nombre del agente HTTP. Por defecto es MLSearcher

public void request()

Consulta y almacena los sitios

Throws: Exception - Si falla la consulta

public Map<String,String> getSites()

Obtiene los sitios

Retorna: Identificadores y nombres de los sitios

Ejemplo

El fichero Example.java muestra como usar la librería.

screenshot1 screenshot2

About

Librería de Java para hacer búsquedas utilizando la API de Mercado Libre

License:GNU General Public License v3.0


Languages

Language:Java 100.0%