|
| 1 | +## EDownloaderInfo.java |
| 2 | +#### Descrição: |
| 3 | + |
| 4 | +##### Esta pequena classe possui a função de resgatar as informações disponíveis nos álbuns do website e-hentai. |
| 5 | +##### Esta classe permite, por exemplo, obter o endereço de todas as imagens disponíveis no álbum, o nome do álbum, o idioma do álbum, se foi traduzido ou não, o uploader, a data do upload, o tamanho do álbum e a quantidade de imagens disponíveis no álbum. Com isso, será possível baixar as imagens utilizando os endereços resgatados. |
| 6 | +##### Para isso, a classe utiliza a biblioteca [org.jsoup](https://github.com/jhy/jsoup) para obter estas informações diretamente do álbum. |
| 7 | + |
| 8 | +##### É possível inicializar o objeto EDownloaderInfo utilizando apenas a URL do álbum em String da seguinte maneira: |
| 9 | +```Java |
| 10 | +EDownloaderInfo e = new EDownloaderInfo(String albumURL); |
| 11 | +``` |
| 12 | + |
| 13 | +##### Após inicializar o objeto com a URL do álbum desejado, basta chamar o método getInfo() para iniciar o processo de resgate de valores: |
| 14 | +```Java |
| 15 | +EDownloaderInfo e = new EDownloaderInfo(url); |
| 16 | +e.getInfo(); |
| 17 | +``` |
| 18 | + |
| 19 | +##### Dependendo do álbum escolhido, este processo pode levar um tempo, deixando a Thread principal ocupada. É recomendável que você utilize esta classe em uma Thread separada, especialmente se estiver utilizando alguma interface gráfica ou integrando diretamente em um aplicativo Android. |
| 20 | + |
| 21 | +##### Se o processo for bem sucedido, será possível obter os valores resgatados utilizando alguns métodos. Abaixo está a descrição de todos eles: |
| 22 | +```Java |
| 23 | +// Verificando se o processo foi concluído com sucesso |
| 24 | +public boolean isSuccessful(); |
| 25 | + |
| 26 | +// Resgata link absoluto das imagens |
| 27 | +public ArrayList<String> getImages(); |
| 28 | + |
| 29 | +// Resgata número de páginas (imagens) do álbum |
| 30 | +public int getAlbumSize(); |
| 31 | + |
| 32 | +// Resgata nome do álbum |
| 33 | +public String getAlbumName(); |
| 34 | + |
| 35 | +// Resgata o idioma do álbum |
| 36 | +public String getAlbumLanguage(); |
| 37 | + |
| 38 | +// Verificando se o álbum é uma tradução |
| 39 | +public boolean isTranslated(); |
| 40 | + |
| 41 | +// Resgatando nome do uploader |
| 42 | +public String getUploader(); |
| 43 | + |
| 44 | +// Resgatando data do upload (yyyy/MM/dd - HH:mm) |
| 45 | +public String getUploadDate(); |
| 46 | + |
| 47 | +// Resgatando tamanho do álbum (arquivos) |
| 48 | +public String getFileSize(); |
| 49 | + |
| 50 | +// Resgata mensagem de erro (se houver, caso contrário retorna String vazia) |
| 51 | +public String getError(); |
| 52 | +``` |
| 53 | + |
| 54 | +#### Requerimentos: |
| 55 | + - Java 8 |
| 56 | + - org.jsoup |
| 57 | + |
| 58 | +#### Exemplo de uso: |
| 59 | +```Java |
| 60 | +// albumURL é uma String, contendo o endereço do álbum desejado |
| 61 | +EDownloaderInfo e = new EDownloaderInfo(albumURL); |
| 62 | +e.getInfo(); |
| 63 | + |
| 64 | +if(e.isSuccessful()) { |
| 65 | + System.out.println("Nome do álbum: " + e.getAlbumName()); |
| 66 | + System.out.println("Idioma: " + e.getAlbumLanguage()); |
| 67 | + System.out.println("Tradução: " + e.isTranslated()); |
| 68 | + System.out.println("Uploader: " + e.getUploader()); |
| 69 | + System.out.println("Data: " + e.getUploadDate()); |
| 70 | + System.out.println("Tamanho: " + e.getFileSize()); |
| 71 | + System.out.println("Número de páginas: " + e.getAlbumSize()); |
| 72 | + |
| 73 | + System.out.println("\nLink absoluto das imagens:"); |
| 74 | + System.out.println("--------------------------"); |
| 75 | + |
| 76 | + For(String img : e.getImages()) { |
| 77 | + System.out.println(img); |
| 78 | + } |
| 79 | +} |
| 80 | +else { |
| 81 | + System.out.println("Erro! Não foi possível resgatar informações do álbum!"); |
| 82 | + System.out.println("Erro: " + e.getError()); |
| 83 | +} |
| 84 | +``` |
| 85 | + |
| 86 | +##### Ao utilizar uma URL correta para o álbum, o processo poderá ser iniciado sem grandes problemas. Caso utilize uma URL que não pertença ao e-hentai.org, isSuccessful() irá retornar falso e uma mensagem de erro será gerada para getError(). |
0 commit comments