'. '

From APIDesign

Jump to: navigation, search

Apache HTML/Java API 1.5 has been released! - 2017-10-24 13:53:00

Hear the news! As of Oct 23, 2017, there is a release of ApacheNetBeans subproject: HTML/Java API. Hooray NetBeans continues to move on the Apache path! Next target? Apache NetBeans Platform...

--JaroslavTulach 13:53, 24 October 2017 (UTC)

Midlife Crisis of an API Designer - 2017-05-05 16:08:00

I have to admit I am currently at a midlife crisis. I dedicated my last twenty years to promotion of a proper API design. I wrote TheAPIBook, I tried to propagate the principles of good APIDesign and modularity wherever I could. However I am tired...

Because it is always the same. Why do I have ask: where is your Usecase? What this method is good for? What do you actually want to achieve with this method/class/type? Have you considered the difference between APIvsSPI aspects of your design? Do you have a unit test? Is your proposed change BackwardCompatible? Do you have an evolution story for your design? Is your solution optimized for your comfort or comfort of users of your API? And so on and so on... People should read TheAPIBook before attempting to design an API, but they don't and they make the same mistakes again and again.

I got so disgust that I feel sick, physically sick, when I have to think about API design. Last weekend Toni asked me to review an API he is creating and showed me what he has. I starred at him, then at the code and at him, etc. for three minutes before I could say a word. Then I had to apologize and describe my current MidlifeCrisis.

When I look at an API these days, all I see is the wasted potential the API could have, but it doesn't and never will, because the amount of investment I would have to do to educate the API stakeholder is so huge, that I just don't want to make it.

Anyway, if you have an API that you'd like me to improve, let me know. If I see real interest in proper API design my disgust and MidlifeCrisis may go away...

--JaroslavTulach 16:08, 5 May 2017 (UTC)

Advanced Injection in Jersey - 2017-03-15 05:27:00

I've just learned a new trick: proper way to do JerseyInjection. Maybe somebody finds it useful...

--JaroslavTulach 05:27, 15 March 2017 (UTC)

My GeeCONPrague Keynote is Online! - 2017-01-04 03:44:00

My GeeCONPrague keynote is available online. Watch my metamorphosis yourself:

Once you survive it and get to 5th minute, you'll also see interesting demos showing how fast the GraalVM and Truffle can be. Thanks again GeeCON guys for giving me a chance to speak at your keynote.

--JaroslavTulach 03:44, 4 January 2017 (UTC)

CleanCode at OracleLabs - 2016-10-29 10:16:00

This is how we write CleanCode! At GeeCONPrague 2016 all OracleLabs speakers ware our classical outfit. The claim was that it helped us write CleanCode:

--JaroslavTulach 10:16, 29 October 2016 (UTC)

Keynote at GeeCON Prague - 2016-10-22 06:27:00

GeeCON has come to Prague and I had a the pleasure to do an initial keynote talk. It is so great when such conference comes to your home town! Thanks a lot dear, GeeCON organizers!

--JaroslavTulach 06:27, 22 October 2016 (UTC)

Distribute Non-distributable - 2016-09-12 08:55:00

AutoUpdate is a fine NetBeans technology that can help you distribute things may see non-distributable. Here is a small demo that shows how one can fix broken NetBeans 8.1 installation.

--JaroslavTulach 08:55, 12 September 2016 (UTC)

Write Business Logic First, Choose UI Later! - 2016-05-09 03:45:00

The ControlsJS guys decided to port my MineSweeper game to their rendering technology and make it available at iOS AppStore:

Image:MineSweeperControls.jpeg

This shows how extremely portable applications written with netbeans:Html4Java APIs are! In fact you can write your application code first and because it is completely independent from the UI, you can completely revamp the UI later.

Isn't this the flexibility we always wanted? Read the whole story...

--JaroslavTulach 03:45, 9 May 2016 (UTC)

Run JUnit in Your (Java Plugin-less) Browser! - 2016-04-30 07:24:00

Bck2Brwsr 0.19 comes with many little improvements and one new feature: it can execute JUnit in the browser!

  • Better support for Annotation - so good that bck2brwsr can now execute JUnit tests
  • Support for all classes from java.util.concurrent package, so JUnit runs without problems
  • Switching to version 2.1.0 for retrolamda
  • More robust generated JavaScript file - doesn't override already defined classes
  • Uses version 1.3 of netbeans:Html4Java API.
  • Record name of an OSGi bundle to be used when Maven coordinates are missing like in JUnit case
  • Don't convert Date objects to current time millis
  • Use boolean.valueOf() to simplify mixing of boxed and unboxed booleans
  • Perform more conversions before returning Java value to JavaScript from a Java callback
  • Launcher.createBrowser can specify its own page
  • Make sure class cast exception contains the same message as produced by JDK
  • Convert undefined value read from arrays into null
  • Convert content of array properly before entering JavaScript
  • Turning the bck2brwsr VM into an OSGi bundle
  • Introducing vmtest.precompiled=<regexp> property to verify that bck2brwsr generated resources are really used
  • Don't include VM in VMTest initialization, let it be loaded on demand
  • System.exit terminates associated launcher
  • eval(JavaScriptResource) as string to prevent double obfuscation
  • Don't report warnings when generating minified version of bck2brwsr libraries

Get the bits from the Maven central repository!

--JaroslavTulach 07:24, 30 April 2016 (UTC)


Giving Up on Apple AppStore - 2016-04-09 06:13:00

My MineSweeper application available from AppStore is gone. Apple wants me to pay remedies every year! For what!? Apple has no cost distributing my application. I am giving up. If somebody wants to distribute my MineSweeper, please go on, but I am giving up - giving up on Apple.

--JaroslavTulach 06:13, 9 April 2016 (UTC)

HTML/Java API 1.3 is Released! - 2016-04-08 03:33:00

I'd like to announce that the new version of HTML/Java API - e.g. 1.3 is ready for usage. The javadoc is at http://bits.netbeans.org/html+java/1.3/ - and the bits has been uploaded to Maven central.

HTML/Java 1.3 comes with many improvements that will make your life easier and enlarge the options you have when mixing Java and HTML. Let me quote the Javadoc:

Model classes can have per-instance private data. Model classes can generate builder-like construction methods if builder prefix is specified. Property.mutable() can be false to define a non-mutable (almost constant) property. That in case of Knockout bindings means: the property is represented by a plain value rather than an observable in the JavaScript object. The JavaFX presenter can be executed in headless mode - just specify -Dfxpresenter.headless=true when launching its virtual machine and no window will be shown. This is particularly useful for testing. OSGi headers are now enterprise OSGi ready. Switched to minified version 3.4.0 of knockout.js. Better support for recursive @Model definitions. New module org.netbeans.html:xhr4j provides implementation of Transfer with technology identifier xhr4j - this module can be used to workaround limitations of CORS by handling the OnReceive connections in Java.

--JaroslavTulach 03:33, 8 April 2016 (UTC)

API Design under Attack! - 2016-02-10 19:54:00

Today my colleagues from NetBeans noticed that my website - wiki.apidesign.org is under attack. Yes, since Jan 16, 2015 there were more than 5000 randomly modified pages. Maybe my talk in Grenoble was so popular that it attracted that much attention!?

Anyway I had to revert back to older copy of the database and re-apply my edits manually. Not everything looks the same as it did before, but hopefully no texts are lost.

In any case, I disabled ability to edit the pages. If you want to talk to me, use twitter and reference my handle: @JaroslavTulach

--JaroslavTulach 19:54, 10 February 2016 (UTC)

Snowcamp in Grenoble gave Bck2Brwsr 10x Speed Up! - 2016-01-28 07:56:00

Bck2Brwsr version 0.17 is faster. Ten years ago nobody would imagine dynamic languages could get as good performance as they have now. The feeling that JavaScript just can't be fast is presumably present in many of our souls. The truth is, it can be relatively fast - not as fast as Java as my experiment with Sieve of Eratosthenes shows, but pretty damn fast. Certainly not an excuse to be ten times slower than HotSpot (which was the previous state of Bck2Brwsr).

The daily work on Truffle compiler team and the time I got when traveling from Snowcamp at Grenoble gave me a chance to speed Bck2Brwsr up. The sieve being a nice - e.g. small and focused - benchmark. Originally the algorithm couldn't be finished in a reasonable time when running on old version of Bck2Brwsr, but knowing what optimizing compilers seek for, it was relatively easy to speed it up ten times.

With great pleasure I announce that Bck2Brwsr, the most complete Java VM in browser (that can run Javac as shown by Dew project) has been sped up many times being at most three times slower than HotSpot. Given the primary goal of Bck2Brwsr is modularity and not speed, I consider it a good sped up even knowing there is a room to make it even faster.

Enjoy the Bck2Brwsr 0.17's speed!

--JaroslavTulach 07:56, 28 January 2016 (UTC)


MineSweeper 3.0 for Your iOS Device. The Christmas Thriller Edition! - 2015-12-18 05:07:00

In September 2015 I decided to update the MineSweeper on AppStore to version 3.0. With a great pleasure I can announce that now, on December 18, 2015 the version is alive! Why it took so long?

Well, Apple's itunesconnect website is unusable - it isn't enough to upload new version of your application and press button Request Review. The user interface is completely messed up and hidden to make the process as obscure as possible. As a result MineSweeper was laying on the AppStore for six weeks before I found the right address (also pretty hidden) to complain at and was explained what is wrong.

Then, of course, the usual reject. This time it was due to Using images that resemble(!) Apple logo - yes, the MineSweeper is using Safari and iOS icon (check the on-line version). But these icons were present in the previous AppStore version as well. And version 2.3 was approved! Clearly the whole review process suffers from the human factor of the reviewer. What some reviewers find appropriate isn't appropriate for others.

How can I know this is a human factor? Because the new version of the MineSweeper of iOS comes with three translations - English, Czech and German (thanks to Toni) - and I am sure the reviewers checked just the English one. If the check was automatic - e.g. some scan through the binary - my submission might have been rejected again. Thankfully it wasn't. It is great we made it before Christmas, as next week the whole AppStore team is going for a vacation...

Here are the changes against standard MineSweeper source code to make the application releasable on the AppStore this time: https://github.com/jtulach/minesweeper/compare/9fc7970496a...0d6984c73

Enjoy version 3.0 of Fair MineSweeper on AppStore. Visit https://itunes.apple.com/us/app/fair-minesweeper/id903688146 to play fair!

--JaroslavTulach 05:07, 18 December 2015 (UTC)

OracleLabs in Prague is Hiring! - 2015-10-07 07:44:00

OracleLabs has a team in Czech Republic and is looking for new candidates to expand it. Innovation is feeding us, but that doesn't mean you have to be a scientist. We have enough clever people - we need also somebody to work!

In case you are interested in conquering the world with the fastest (J)VM on the planet backed by a strong tooling (based on NetBeans) write to me.

--JaroslavTulach 07:44, 7 October 2015 (UTC)

Can Java Speed Ruby up? Yes, ten times! - 2015-10-02 12:28:00

Speed of Ruby has never been great. There were many attempts to improve it, but none delivered on its promise. All failed, but one! JRuby implementation running on top of JVM spiced with a bit of Truffle and Graal is in fact ten times faster than standard Ruby version.

Watch this video to see how can Java and its virtual machine help those other poor and slow languages!

--JaroslavTulach 12:28, 2 October 2015 (UTC)

Speaking at JDD in Krakow - 2015-09-25 09:31:00

I'll be speaking at JDD in Krakow in middle of October. In case you have a Java related message to deliver to the JDD galaxy, leave it here. I'll do my best to deliver it.

Image:Jdd2013.png

I enjoyed Krakow JDD conference in 2013 and based on my experiences I wrote the languages essay. Now I am invited to speak at JDD 2015 about Truffle and Graal and while there I am also going to do a workshop about DukeScript.

If you have a message that I should share with visitor's in Krakow, leave it here:

Name (required):

Comment:

--JaroslavTulach 09:31, 25 September 2015 (UTC)

Truffle Debugging in NetBeans 8.1 - 2015-09-11 14:10:00

Debugging any Truffle language is now quite easy in NetBeans 8.1! Check the video:

--JaroslavTulach 14:10, 11 September 2015 (UTC)

HTML/Java version 1.2.1 has been Released! - 2015-09-02 06:16:00

Cross platform UI library called HTML/Java API (which is developed by the NetBeans project) is proud to announce that version 1.2 has just been released on Maven central. See javadoc to find out what is new in this version!

The project is also glad that binaries of the new HTML/Java version 1.2 are now included in forthcoming NetBeans 8.1 release making it easy to develop wizards as well as components and dialogs in a cross-platform manner (e.g. able to run in NetBeans platform applications, IDE, Eclipse RCP, plugin-less browser and thanks to adoption by DukeScript project also on iOS and Android).

HTML/Java API is the heart of Java that is written once, and displayed everywhere!

--JaroslavTulach - HTML/Java inventor 06:16, 2 September 2015 (UTC)

Design with Truffle. Get Debugger for Free! - 2015-06-24 16:04:00

Truffle - a modern way to write AST interpreters - gives you not only speed, but also debugger for free:

Image:TruffleDebugger.png

The picture shows NetBeans debugger stopped in middle of simple language (an artificial language used for demo purposes) method. NetBeans knows nothing about simple language (that is why syntax coloring is missing), but as NetBeans understands the Truffle AST, it can still provide enough valuable information in the debugger.

Please note that the name of the method is properly recognized and shown on top of the stack. Variables a and b and their values are properly shown as well.

Designing your own language? Do you want to spend time writing a debugger? If not, use Truffle and you'll get your debugger for free!

--JaroslavTulach 16:04, 24 June 2015 (UTC)

JavaScript is a New Assembly Language - 2015-04-05 21:02:00

Ever felt JavaScript is your carrier path? Well, maybe you should re-think you future! JavaScript is just another assembly language!

--JaroslavTulach 21:02, 5 April 2015 (UTC)

NetBeans History: University Beginnings - 2015-03-20 16:04:00

The original name of the project was Xelfi and it started at MatFyz faculty of Charles University in middle of 90-ties. However it was so successful that it had to turn into something as successful as NetBeans. In case you are satisfied with your IDE, consider reading about its root...

--JaroslavTulach 16:04, 20 March 2015 (UTC)

Can Real Threads be Brought to JavaScript? - 2015-01-22 09:52:00

What it would take to bring Java like threads into JavaScript (via Bck2Brwsr VM)? Here is my [[1]]!

--JaroslavTulach 09:52, 22 January 2015 (UTC)

Bck2Brwsr @ 0.13 Released - 2015-01-12 09:27:00

Bugfix release of Bck2Brwsr 0.13 is out and it powers another classical game: fifteen. Give it a try!

--JaroslavTulach 09:27, 12 January 2015 (UTC)

Bck2Brwsr @ 0.12 Released - 2015-01-01 21:53:00

Bck2Brwsr 0.12 has been released. What is new?

Libraries can be pre-compiled and published as Maven artefacts (see Bck2BrwsrLibraries how to). The Knockout4Java Maven archetype has been modified to use the precompiled version of Bck2Brwsr rt. jar emulation library and HTML/Java APIs:

$ mvn archetype:generate \
  -DarchetypeGroupId=org.apidesign.html \
  -DarchetypeArtifactId=knockout4j-archetype \
  -DarchetypeVersion=1.1.2 \
  -Dbck2brwsr=true
# answer few questions...
$ cd nameofyourproject
# run on desktop
$ mvn process-classes exec:java
# run in a browser
$ mvn -Pbck2brwsr clean package bck2brwsr:show

Supporting Bck2BrwsrBlobURLs so one can display images available as in JAR resources.

Happy Year 2015 and please help me get Java Bck2Brwsr!

--JaroslavTulach 21:53, 1 January 2015 (UTC)

Wrap Your JAR as OSGi Bundle via Maven Easily! - 2014-11-29 13:07:00

See the tutorial at OSGiWrapper.

--JaroslavTulach 13:07, 29 November 2014 (UTC)

Duke Choice Award - 2014-09-29 17:37:00

DukeScript has been awarded a Duke Choice Award! Here is picture of Toni Epple and me holding the Duke Choice Award on Sep 28, 2014:

Image:DukeChoiceAward.jpg

Long live Java and HTML on every device (iOS, Android and co.)!

--JaroslavTulach 17:37, 29 September 2014 (UTC)

Play MineSweeper to Become iOS, Android, JavaFX &amp; co. Developer - 2014-09-15 10:57:00

Since Sep 15, 2014 the MineSweeper NetBeans integration can be used as a starting point to develop own DukeScript applications. Just press the Develop button and a new project wizard will be opened as following picture shows:

Image:MineSweeperDevelop.png

--JaroslavTulach 10:57, 15 September 2014 (UTC)

JavaOne2014: Need Speakers for My Session! - 2014-09-10 18:56:00

JavaOne2014 is around the corner and my sessions have been scheduled. I start with a BOF on Monday evening called Virtually Inside-Out! - it is going to be discussion between authors of alternative JVMs. So far we are two: I have mine Bck2Brwsr and Niklas has RoboVM.

Don't you know a developer working on own JVM who will be at JavaOne2014? If so, please tell him to contact me and stop by! I plan to make the BOF a lively chat (how did you implemented lambdas?, how did you implemented defender methods?), but in case we don't have a topic to talk about, I am ready to explain why value classes should not be in JVM and why InvokeDynamic is a completely stupid idea. Anyone from JDK team to defend these proposals?

On Tuesday morning Toni and me will continue with DukeScript tutorial. In case you use Java and want to learn how to code for iOS, Android, JavaFX and browsers, stop by. We will help you create your first application that is written once and displayed anywhere!

I'll finish on Tuesday noon talking about API Design checklist. I'd like to name at least ten things one should check for, but so far I have about two. Don't you have any idea what could be in such checklist? If so, please talkback!

--JaroslavTulach 18:56, 10 September 2014 (UTC)

Develop in NetBeans and Deploy to AppStore - 2014-08-21 15:29:00

Minesweeper for iOS has been published. First iBrwsr powered DukeScript application has been deployed to AppStore. If you own an iPad or iPhone, give it a try: https://itunes.apple.com/us/app/fair-minesweeper/id903688146

And don't forget you can use NetBeans to develop such applications yourself! Install DukeScript NetBeans support.

--JaroslavTulach 15:29, 21 August 2014 (UTC)

Develop in NetBeans and Deploy to GooglePlay - 2014-07-31 05:17:00

Minesweeper for Android has been published. First DlvkBrwsr powered DukeScript application has been deployed to GooglePlay. Give it a try: https://play.google.com/store/apps/details?id=org.apidesign.demo.minesweeper

And don't forget you can use NetBeans to develop such applications yourself! Install DukeScript NetBeans support.

--JaroslavTulach 05:17, 31 July 2014 (UTC)

Japanese Translation is Real - 2014-07-17 06:51:00

Cover of Japanese translation of TheAPIBook. I am amazed, the book is about 30% shorter, yet is seems to contain all the content of the original one!

Image:PracticalAPIDesignInJapanese.jpg

Great work Yoshiki!

--JaroslavTulach 06:51, 17 July 2014 (UTC)

Bck2Brwsr Revision 0.9 is Released! - 2014-06-10 06:34:00

Version 0.9 eliminates useless stack assignments. Instead of doing

var stI0 = lcI0;
var stI1 = lcI1;
var stI0 = stI0 + stI1;
return stI0;

the now generated code is

return lcI0 + lcI1;

which is shorter and more human readable. However I doubt the V8 virtual machine sees any benefits - I think the final native code remains the same. But at least the debugging of the generated JavaScript code is now easier - there is less Step Over invocations and it mimics more closely the original Java source.


Optimized the ahead-of-time compilation, so now the http://xelfi.cz/minesweeper/bck2brwsr/ demo starts up instantly. I had to do it, because it was so embarrassing to see TeaVM to boot the same application so quickly: The initial delay is gone, and moreover it downloads necessary libraries in parallel and on background. Now we are ready for next step: share the libraries between different applications.

Can ObfuscatePerLibrary - e.g. each JAR gets compiled ahead-of-time into its own JavaScript file, which can be shared between many applications.

--JaroslavTulach 06:34, 10 June 2014 (UTC)

Podcast related to Japanese Translation - 2014-06-02 18:45:00

Japanese translation announcement: --JaroslavTulach 18:45, 2 June 2014 (UTC)

Debug Mixed Java/JavaScript Applications - 2014-02-20 15:53:00

Before Nashorn (the JDK8 JavaScript engine) performing calls between Java and JavaScript was a pain. Especially when it came to debugging. But now, one can completely freely mix Java and JavaScript inside of a single thread and still be able to debug and inspect the slightest details of Java as well as JavaScript stack frames.

See video showing the power of the synergy between NetBeans 8.0 and Nashorn!

--JaroslavTulach 15:53, 20 February 2014 (UTC)

Japanese Translation of Practical API Design - 2014-01-27 09:28:00

The Japanese translation of my book has been in progress for several months. Recently I've been asked by Yoshiki to write a preface.

I wrote one and I tried to express how wonderful experience it had been to participate in the Japanese translation. I believe the Japanese version of my book will be great.

Thanks Yoshiki for your work. Dear (Japanese reading) readers, enjoy!

--JaroslavTulach 09:28, 27 January 2014 (UTC)

Unify Eclipse and NetBeans UI - 2013-12-21 18:01:00

I've managed to prototype a way to share UI between two rich client platforms. These days it is popular to use HTML, so I did it. However in addition to that I managed to remove all need for JavaScript. Design in HTML and code your application logic in Knockout4Java.

See how!

--JaroslavTulach 18:01, 21 December 2013 (UTC)

JavaFX for iOS via NetBeans - 2013-12-10 12:42:00

I am pleased to announce there is now a way to develop applications for iOS using your favorite language (I mean Java) and your favorite development IDE (I mean NetBeans).

With the help of Prague's JavaFX iOS team we now have a NetBeans plugin that helps anyone develop JavaFX based Java apps for iOS. Many thanks should also go to RoboVM guys for creating such easy to use Maven plugin.

Enjoy JavaFX on iOS!

--JaroslavTulach 12:42, 10 December 2013 (UTC)

API Design Guidelines - 2013-12-02 09:30:00

I have discovered a nice checklist of guidelines considered good for API design.

--JaroslavTulach 09:30, 2 December 2013 (UTC)

Cloud IDE for Kids - 2013-12-02 08:48:00

Scratch is getting better and better. If you have not done that yet, give it a try!

--JaroslavTulach 08:48, 2 December 2013 (UTC)


The Smallest Linux JDK - 2013-11-27 15:12:00

The profiles support is coming for JDK8. Not only it is coming, it works! In case you are searching for a small Java, give profiles a try. They are easy to start with.

--JaroslavTulach 15:12, 27 November 2013 (UTC)

DEW - Java Meets Web with Your Help! - 2013-10-28 16:56:00

I'm proud to announce DEW - the development environment for web (of course in Java). I am tired of observing JavaScript being on the rise while pretending it is more than just a script language. The real language is Java and it does quite well with HTML. Check DEW here: http://dew.apidesign.org/dew/ and you will not regret!

The more you fiddle with DEW and the more you alter (and save) the samples, the more we will help Java get Bck2Brwsr!

--JaroslavTulach 16:56, 28 October 2013 (UTC)

Maven and Bck2Brwsr 0.8 - 2013-09-29 12:22:00

I've just updated instructions to use bck2brwsr 0.8 from command line. Me and Jonathan Fuerth also verified that the Bck2Brwsr Maven archetype can now be used in Eclipse.

Nothing can stop us from bringing Java Bck2Brwsr!

--JaroslavTulach 12:22, 29 September 2013 (UTC)

Use the Debugger, Stupid! - 2013-08-20 09:17:00

Debugger is a very useful tool. I greatly recommend it to everyone who asks stupid questions on mailing lists and reports vague bugs into bug tracking systems. If your application does not work: use the debugger! Read here to learn how.

--JaroslavTulach 09:17, 20 August 2013 (UTC)

Bck2Brwsr 0.7 Released! - 2013-05-09 07:50:00

Write applications once and deploy them to FXBrwsr as well as Bck2Brwsr:

--JaroslavTulach 07:50, 9 May 2013 (UTC)

Bck2Brwsr 0.6 is Released! - 2013-04-14 21:24:00

Now you can write your own real applications for browser in Java:

  • Full featured demo Twttr demo
  • Bck2Brwsr provides better binding of complex classes (defined by a special @Model) annotation
  • The @Model classes can be obtained from a server via JSON and JSONP. Use @OnReceive annotation
  • Browser testing harness has nicer output with UL and expandable LI

--JaroslavTulach 21:24, 14 April 2013 (UTC)

Older Blog Posts - 2013-04-14 21:00:00

OlderBlogPosts...

--JaroslavTulach 21:00, 14 April 2013 (UTC)


Personal tools