Java-Gaming.org    
Featured games (81)
games approved by the League of Dukes
Games in Showcase (482)
Games in Android Showcase (110)
games submitted by our members
Games in WIP (550)
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  
  Java NIO docummentation  (Read 2689 times)
0 Members and 1 Guest are viewing this topic.
Offline vrm

Junior Member




where I should sign ?


« Posted 2004-04-02 04:07:05 »

here the rant  Angry

I'm working since a few moment with NIO sockets and I ammazed how poor is Sun doc about it (the best is prolly the JDK source and blah³ article). I think the main advantage of java for gaming is the fancy deployement/network/portability (at least in my view). and I found it pittyfull the way NIO is documented (try to find a working example/tutorial). It's not that new now, it's there since first release of 1.4 . I propose my help, for write tutorials (but be carefull of my non-native-techie-english) but I whould like to see a real effort from Sun about documenting his own API...  Roll Eyes
Offline djp

Junior Member





« Reply #1 - Posted 2004-04-06 15:35:46 »

I suppose you have already looked over:
http://java.sun.com/j2se/1.4.2/docs/guide/nio/

it does have a few simple examples.

d
Offline blahblahblahh

JGO Coder


Medals: 1


http://t-machine.org


« Reply #2 - Posted 2004-04-06 15:42:07 »

Quote
I suppose you have already looked over:
http://java.sun.com/j2se/1.4.2/docs/guide/nio/

it does have a few simple examples.

d


The examples are **** (self-censored :O), they even go against some of what the API docs suggest, without explaining why (although eventually I tracked down explanations to the diversions, but not from official channels, just consensus opinion amongst users).

I think I'd actually recommend *avoiding* those examples - they have done some people (read sun's forums, and other forums via google) more harm than good.

Every way you look at it, the NIO doc situation is unacceptable.

malloc will be first against the wall when the revolution comes...
Games published by our own members! Check 'em out!
Legends of Yore - The Casual Retro Roguelike
Offline swpalmer

JGO Coder




Where's the Kaboom?


« Reply #3 - Posted 2004-04-06 20:35:59 »

Quote
Every way you look at it, the NIO doc situation is unacceptable.

Have you filed a bug report against the docs?

Offline blahblahblahh

JGO Coder


Medals: 1


http://t-machine.org


« Reply #4 - Posted 2004-04-06 21:56:10 »

IIRC I've filed about 5 of them Grin. Just against the docs. Mainly against things like "you say X and yet Y happens" or "you don't say whether X is X-1 or X-2, and it's not possible to write an app defensively if the API neither mandates one NOR lets you detect it at runtime".

IIRC in one I even suggested looking at the OpenGL extension mechanisms for inspiration on providing runtime information on what behaviour and/or guarantees the actual implementation was offering

...but I've been using NIO for so long now that I really can't remember Sad. And there's no feature that I've found (so far; but... I haven't checked in a long time, so perhaps you can now?) that lets you search for "my filed bugs" - you have to retain the email with the URL / bug number or else lose it Sad. I think I filed an RFE on that a couple of years ago Grin

malloc will be first against the wall when the revolution comes...
Offline Mark Thornton

Senior Member





« Reply #5 - Posted 2004-04-07 11:47:00 »

Quote
remember Sad. And there's no feature that I've found (so far; but... I haven't checked in a long time, so perhaps you can now?) that lets you search for "my filed bugs" - you have to retain the email with the URL / bug number or else lose it Sad. I think I filed an RFE on that a couple of years ago Grin

Searching on my nickname (mthornton) gets most of mine. Of course it also include bugs where I have commented rather than being the author.
Offline djp

Junior Member





« Reply #6 - Posted 2004-04-08 19:54:00 »

Quote


The examples are **** (self-censored :O), they even go against some of what the API docs suggest, without explaining why (although eventually I tracked down explanations to the diversions, but not from official channels, just consensus opinion amongst users).

I think I'd actually recommend *avoiding* those examples - they have done some people (read sun's forums, and other forums via google) more harm than good.

Every way you look at it, the NIO doc situation is unacceptable.



Hmmm, that's what I get for not actually looking at the docs before recommending them....

d
Offline blahblahblahh

JGO Coder


Medals: 1


http://t-machine.org


« Reply #7 - Posted 2004-04-08 20:11:29 »

Quote

Searching on my nickname (mthornton) gets most of mine. Of course it also include bugs where I have commented rather than being the author.


Ah. I don't have a JDC id (I don't want yet another pointless password and someone knowing enough details about me to steal from my bank account), which may be the problem!

malloc will be first against the wall when the revolution comes...
Offline wooD

Senior Newbie




J2ME Developer


« Reply #8 - Posted 2004-04-13 12:55:33 »

JavaNIO by Ron Hitchens is a great book on NIO.
http://www.javanio.info/

I got my NIO server working by using the book. I'm on another mail list with Ron and he was even helpfull when I had some further questions.

His little tool (BufferDemo) on that website was very helpful in understanding buffers.  I think the method names on the Buffer class are terribly named and not intuitive at all. Ron's tool helps.

My only complaint was his design using worker threads needed more detail, but I did manage to get my version working.

Wood

Offline blahblahblahh

JGO Coder


Medals: 1


http://t-machine.org


« Reply #9 - Posted 2004-04-13 14:46:52 »

Quote
JavaNIO by Ron Hitchens is a great book on NIO.
http://www.javanio.info/
Wood


Disclaimer: I've only read about half the book so far.

Ron's book doesn't have anything meaty in it. It basically teaches you how to use the API in the abscence of having to do any real programming with it.

When I contacted him, he wasn't even aware of basic fundamental bugs in gathering writes that made them unusable.

The book is expressly *not* a book from a battle-hardened expert on how to use a tool, and it doesn't give you much help in using the API "in anger".

OTOH, as an aid to learning and understanding the sparsely documented API, it's great.

malloc will be first against the wall when the revolution comes...
Games published by our own members! Check 'em out!
Legends of Yore - The Casual Retro Roguelike
Offline vrm

Junior Member




where I should sign ?


« Reply #10 - Posted 2004-04-14 05:42:01 »

it's a bit expensive too  Grin
Offline blahblahblahh

JGO Coder


Medals: 1


http://t-machine.org


« Reply #11 - Posted 2004-04-18 10:04:15 »

Quote
here the rant  Angry

I'm working since a few moment with NIO sockets and I ammazed how poor is Sun doc about it (the best is prolly the JDK source and blah³ article).


Now (finally) on the JGF site: http://grexengine.com/sections/externalgames/

and if you can produce a good article on any other aspect of NIO, send me a message and we'll see about getting yours up there too.

malloc will be first against the wall when the revolution comes...
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.

CopyableCougar4 (14 views)
2014-08-22 19:31:30

atombrot (28 views)
2014-08-19 09:29:53

Tekkerue (25 views)
2014-08-16 06:45:27

Tekkerue (23 views)
2014-08-16 06:22:17

Tekkerue (15 views)
2014-08-16 06:20:21

Tekkerue (22 views)
2014-08-16 06:12:11

Rayexar (61 views)
2014-08-11 02:49:23

BurntPizza (39 views)
2014-08-09 21:09:32

BurntPizza (31 views)
2014-08-08 02:01:56

Norakomi (37 views)
2014-08-06 19:49:38
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

List of Learning Resources
by SilverTiger
2014-07-31 11:54:12

HotSpot Options
by dleskov
2014-07-08 01:59:08
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!