Java-Gaming.org Hi !
Featured games (83)
games approved by the League of Dukes
Games in Showcase (522)
Games in Android Showcase (127)
games submitted by our members
Games in WIP (590)
games currently in development
News: Read the Java Gaming Resources, or peek at the official Java tutorials
 
    Home     Help   Search   Login   Register   
Pages: [1]
  ignore  |  Print  
  A lot of these methods aren't implemented...  (Read 1271 times)
0 Members and 1 Guest are viewing this topic.
Offline victorwang

Senior Newbie




i will be uberjavaman


« Posted 2004-08-21 20:53:04 »

Looking through the source, I notice a lot of the methods everywhere (in GeomContainer for example) are completely empty and some just throw an unsupported function error.  I checked to see if any of these dummy methods are implemented in subclasses of GeomContainer but from what I can see, that's all they are -- dummy methods.  I don't see how this is supposed to be beneficial.  Wouldn't it be better just to delete those lines so that the error would show up as a compile error (method isn't there)?  That would be a lot better than having a bunch of useless methods taking up space in the API and confusing newbies like me.  At one point I was trying to use one of these dummy methods for about and hour or two before checking the Xith source to realize the method was completely empty.  It's hard to figure out which method to use because there are so many versions of similarly named methods, and yet many of them have absolutely no use whatsoever, except to confuse.  They should simply be added in when they are implemented.  Or is there some fundamental API design issue I have overlooked...?

Oh yea, and personally I think the most important thing to improve on in Xith right now is the Javadoc.  It's practically non-existant right now..

Another oh yea... Does anybody know of any good Xith guides besides the one on the offical xith.org site?  Didn't find any with Google..

-=uberjavamantobe=-
Offline William Denniss

JGO Coder


Projects: 2


Fire at will


« Reply #1 - Posted 2004-08-21 22:25:42 »

Idealy the dummy methods should:  Throw and exception _or_ log an error message, and should be marked with a special @unimplemented tag in the docs.  They are place holder methods, present for Java3D compatability I think.  Perhaps we need to review them and remove ones which won't ever be implemented (I'm sure there are some).

Regarding Javadoc, I had a poll and topic on the subject recently asking for volunteers but only had 5 people stand up which is not really enough.

It is a long and boring task.  Maybe we need to do something similar to the LWJGL Mac donation drive and get a donation pool going?

Will.

Offline victorwang

Senior Newbie




i will be uberjavaman


« Reply #2 - Posted 2004-08-22 05:32:52 »

Quote
 Maybe we need to do something similar to the LWJGL Mac donation drive and get a donation pool going?


Heh, yeah let's see if Xith gets a grand.  Tongue

-=uberjavamantobe=-
Pages: [1]
  ignore  |  Print  
 
 
You cannot reply to this message, because it is very, very old.

 

Add your game by posting it in the WIP section,
or publish it in Showcase.

The first screenshot will be displayed as a thumbnail.

trollwarrior1 (33 views)
2014-11-22 12:13:56

xFryIx (73 views)
2014-11-13 12:34:49

digdugdiggy (52 views)
2014-11-12 21:11:50

digdugdiggy (46 views)
2014-11-12 21:10:15

digdugdiggy (40 views)
2014-11-12 21:09:33

kovacsa (65 views)
2014-11-07 19:57:14

TehJavaDev (70 views)
2014-11-03 22:04:50

BurntPizza (68 views)
2014-11-03 18:54:52

moogie (83 views)
2014-11-03 06:22:04

CopyableCougar4 (82 views)
2014-11-01 23:36:41
Understanding relations between setOrigin, setScale and setPosition in libGdx
by mbabuskov
2014-10-09 22:35:00

Definite guide to supporting multiple device resolutions on Android (2014)
by mbabuskov
2014-10-02 22:36:02

List of Learning Resources
by Longor1996
2014-08-16 10:40:00

List of Learning Resources
by SilverTiger
2014-08-05 19:33:27

Resources for WIP games
by CogWheelz
2014-08-01 16:20:17

Resources for WIP games
by CogWheelz
2014-08-01 16:19:50

List of Learning Resources
by SilverTiger
2014-07-31 16:29:50

List of Learning Resources
by SilverTiger
2014-07-31 16:26:06
java-gaming.org is not responsible for the content posted by its members, including references to external websites, and other references that may or may not have a relation with our primarily gaming and game production oriented community. inquiries and complaints can be sent via email to the info‑account of the company managing the website of java‑gaming.org
Powered by MySQL Powered by PHP Powered by SMF 1.1.18 | SMF © 2013, Simple Machines | Managed by Enhanced Four Valid XHTML 1.0! Valid CSS!