Java library

Java library

leiger 06 Jul 2010 01:54

I have pulled out half my hair trying to get this working with Java and I'm about a stone throw away from it finally working. If anyone wishes to create a Java client for the Wikidot API, I'd gladly help you as much as I can. I nearly gave up several times.

I'll eventually be making a Java library for the Wikidot API, so that access to it using Java is really simple. It'll fully support object-oriented development, allowing you to access specific information about users, sites, categories and pages - and will be updated every time the API itself is updated.

(shameless plug) If you'd like to have a look at my wikidot editor, it will soon have API access added to its list of features. http://editor.wikidot.com

---

~ Shane (Wikidot Community Admin - Volunteer)
Wikidot: Wikidot Editor, Official Docs
Other: YouTube (gaming, primarily Minecraft)

Re: Java library

leiger 06 Jul 2010 13:04

My Java library is working for almost all methods now. The only ones it doesn't work for yet are user.valid, page.save and page.files — everything else I can do with the API, I can also do with my library.

Here's a simple example:

public class TestAPI
{
    public static void main(String[] args) {
 
        final String user = "leiger";
        final String key = "API-KEY";
 
        try
        {
            // Create the API object
            WikidotAPI api = new WikidotAPI(user, key);
 
            // Find out how many sites I am a member of
            User me = new User("leiger");
            Site[] mySites = me.getSites(api);
            // Print to the console
            System.out.println("I am a member of "+ mySites.length +" Wikidot sites!");
 
            // TODO: Do some more cool stuff with the Wikidot API! :D
        }
        catch (Exception e)
        {
            System.out.println("Something went wrong, and an exception was caught. Details follow:");
            System.out.println("CLASS: "+e.getClass());
            System.out.println("MESSAGE: "+e.getMessage());
        }
    }
}

The output for this is:

I am a member of 213 Wikidot sites!

---

~ Shane (Wikidot Community Admin - Volunteer)
Wikidot: Wikidot Editor, Official Docs
Other: YouTube (gaming, primarily Minecraft)

Last edited on 06 Jul 2010 13:11 by leiger Show more

Re: Java library

jnesselr 07 Jul 2010 15:49

Very good. How exactly did you get python working with Java?

Re: Java library

soronlin 07 Jul 2010 15:55

He didn't.

XML-RPC is a standard Internet protocol. There are Java libraries that implement it. So leiger writes only Java and I write only Python. I do not know what language Wikidot write the server in. It might be PHP. But all the languages implement the same protocol, so they can all talk to each other.

I have no Java on my PC, and leiger has no Python on his PC.

Python is just the language that Wikidot used to show example code. There is nothing special about it.

Last edited on 07 Jul 2010 15:58 by soronlin Show more

Re: Java library

leiger 08 Jul 2010 02:58

Well… technically I do have Python on this PC (different OS and partition), I'm just not using it for the Java library! ;-)

---

~ Shane (Wikidot Community Admin - Volunteer)
Wikidot: Wikidot Editor, Official Docs
Other: YouTube (gaming, primarily Minecraft)

Last edited on 08 Jul 2010 02:59 by leiger Show more

Re: Java library

leiger 07 Oct 2010 02:22

The Java library I wrote was based on version 1 of the API… but that is going to be phased-out soon.

I will probably end up writing another library for version 2 of the API, but it will be nowhere near as robust and as extensive as my first one. I.e. most of these things were 95% implemented in my first Java library, but won't be in the second:

• It reacted differently in certain situations if the page existed or not
• Extensively made use of Exception Handling to provide as useful an error message as it could
• Built to be 100% object-oriented

That means I'll be able to finish the new library a lot quicker, but it won't do much for you. Basically it will handle the connection, but leave everything else up to you. When I have time I will improve it to add some of those extras.

At least this time I'll be able to get it 100% finished and actually get around to releasing it, unlike the first one. I'm a perfectionist, and 90% finished wasn't good enough for me to be happy with a release ;-) Due to how often I use comments in my work, I should be able to automatically generate some documentation too.

---

~ Shane (Wikidot Community Admin - Volunteer)
Wikidot: Wikidot Editor, Official Docs
Other: YouTube (gaming, primarily Minecraft)

Re: Java library

soronlin 07 Oct 2010 10:18

Well… technically I do have Python on this PC

Since getting an Android phone, I do have Java on my PC too. If I can grit my teeth hard enough to learn how to write it, that and your library might make for an interesting app…

Re: Java library

leiger 09 Oct 2010 03:08

http://java.wikidot.com
When I get around to updating it… XD

---

~ Shane (Wikidot Community Admin - Volunteer)
Wikidot: Wikidot Editor, Official Docs
Other: YouTube (gaming, primarily Minecraft)

Re: Java library

Ashe 22 Jun 2011 10:49

To resurrect an old topic…

I notice the download page for the Java library doesn't exist. Can I still get a copy? I know it's version 1 — I'm interested in having it as a model / reference.

Re: Java library

leiger 21 Aug 2012 15:01

Just started actively developing this again.

Project website: http://api-java.wikidot.com/

---

~ Shane (Wikidot Community Admin - Volunteer)
Wikidot: Wikidot Editor, Official Docs
Other: YouTube (gaming, primarily Minecraft)