Proceeding with lookup, showing first example

Shortening the lines

Enough of spring

Reference to spring

Fixing examples so their BEGIN starts with space

Slightly different way to do call-outs. With this style the PDF printed from ODF document at least contain the right texts

Making the examples more appropriate for the book

Need a space before BEGIN now

No need for imports

Yet another example of spring autoconfiguration

Adding the lookup version

Showing how such a general registry might look like

Prefer autowire mode

Spring example runs

Spring version that compiles, but does not run

Shortening lines

Made compilable

Simplified with duplication of the code ;-)

Solution with properties

Making anagrams visible

Example with registration methods is working

GUI for anagrams

Simple scrambler

Static world library

Defining APIs for the modular interfaces

Not using deprecated method

Showing regular Anagram game

TopManager example taken from sources

No, NOI18N

Merge: Geertjan's changes to the end of the chapter

to the end of daily_life

Making the example with MixedClass vs. NonMixed solution more real, so it can be unit tested

Splitting Factorial into own class, so Andrei does not need to complain about it having static modifier

Making sure the code survives negative inputs

Show the definition of the cnt variable

reading needs to synchronize as well

Renaming to parallel

Misuses are OK

Using public modifiers

Shortening long line

Reimplementing the lookups once again

More tests, fixing closing tag

Parameter renamed to seq

Using a method that is named to indicate what is its purpose, instead of magic seq.length() < 1024

Use encryptChar

Counting writer does not need author tag

The XMMS example now extracts the code snippets from real files that do compile

Sample polishing requested by Andrei and Jesse. In spite I do not agree it is important - but I do not have power to describe that it is not important. Maybe in a blog.

Jesse wanted to have better example of InstanceProvider. Done, but it is also more complicated: http://wiki.apidesign.org/index.php/A_Method_Addition_Lover's_Heaven

Addressing issues at http://wiki.apidesign.org/index.php/Allow_Access_Only_From_Friend_Code

Cleaning just the sources, not more, building just samples and not other ant tasks

Lines were too long

Merge: Some Patrick's one liner fixes

daily life polishing through 3500

review31: Providing randomized Arithmetica test to verify inconsistencies with version 1.0

Enhancing the example to contain randomized that to verify consistency with previous implementation

Visitor.visit(with self) turned into sample

Adding tests also for 3.0 version of the API

Incorporating Patrick's changes. I am not reall sure about the changes after the war, it is really 'or' it cannot be 'and'. I will change that when I do the reading through the whole chapter.

polishing lines 500-1000

Going through the suggar section

Fixing compilation errors

Third version and tests for client provider visitor

First two versions of client provider Visitor

Complicated dispatch code in Minus version 3.0

Proper dispatch in Real

Wrapper around Real is OK

Testing version 3.0

Need to copy the code also to 3.0 version

It always surprises me how things change when one really tries to implemente them. The whole approach with non-monotinic evolution was uncompilable. We need a common super type for all the visitors\!

Clean definition of the version using interfaces

Expose as less as possible - making constructor of Expression package private

In order to provide better navigation in the Visitor examples, I will prefix them with a number

Last clashing code section for now. Time to sleep

Duplicated code section

Closing up examples of visitor based on abstract class

There was some mischmash between abstractclass and unknownvisit, hopefully fixing it

default traversal described

Fix broken compilation

visitUnknown method introduced

Visitor pattern with abstract class is relatively good

Example with non-extensible visitor

Changed to match the example in the book

Full coverage is not enough

Adding example, however only a sketch, of possible runtime check between alternative versions

Merge: Geertjan's changs up to 2000

up to line 2000

Checking that all examples pair the opening and closing brackets

Adding example with factory method for unsynchronized StringBuffer

Yet another use of Arithmetica

Another use for Arithmetica

Using Arithmetica for yet another example

Alternative behaviour with constructor described on Arithmetica example

Improved to look better in the book code sample

Shortening too long line

Design part is cleared from the non-colorized code snippets

Special project for inidividual samples, used to show code that can be called only from test

Example showing that factory methods have greater flexibility when typing with generics

Build needs to succeed

Line was too long

All TBDs from theory section are resolved

Example of append(StringBuffer)

Another uncompilable example, now it shows problems with double return type

Wild import

Sample code to work with filesystem layers

Beautifies keywords, comments and method names.

Truncating to 75 characters

Truncating all examples to 80 characters per line

Merge: Geertjan's changes

up to line 1000

Adding targets to the build script to also create the samples, make sure they compile and tests execute

Merge: Patrick's fixes

part 2 of polishing "review2" areas

Accepting Jesse's edits

Routine edits in Determining What Makes a Good API.

Merge: Patrick's edits

2nd batch of polishing of review2

We know how to build the source zip file

We are able to run all tests from all the projects

Excluding NetBeans Module which requires NetBeans platform somewhere around

Creating one master script that can clean and build all examples

Removal of setUp and tearDown methods

Accessor changed to use getDefault and setDefault as the original code is said to deadlock

Wrong section labels

This code needs to be included in the PDF

Part II: Practical Design is now ready for review by our reviewers

Memory tests

Reentrant access examples rewritten to make a bit more sence

Sample code with various attempts to fight with reentrant code

Merge: Geertjan's edits

many fixes, but mainly up to 700

Enough of logging, Jesse will anyway advice to delete this part

Advanced usage of logging

Racecondition tests

Deadlock tests: removing ulinks, adding one picture, rewording a bit, adding new examples

Onward! Towards deadlock tests.

Deadlocks on this and internal lock explained

Examples from JavaBeans specification moved out of the XML text

Consistency between type and runtime system

Reviewed and cleaned up till sidemeanings

Clean messages in the API examples

Consistency needs its own tests

How to use wrapping against reexport issues shown in the project

Remove import from own package

Maybe we could show the transitivity problem by create a new API that uses something unrelated from String package, like StringBuffer and switches to StringBuilder, but I am not really sure, so I am putting this to branch

Showing transitive change on the project

Closing the right sample code section

Way simplified internals of the AServerInfo class

review2: Note about Tune and DVB Central. Finished example with AServerInfo

AServerInfo projectized, except the final advice to create the "clonning factory"

review2: ExtIcon example used to demonstrate the beauty of query pattern. two sections merged into one, a bit of reordering. Please review.

Do not use innerclass

How to eliminate cyclic dependencies

How to write extension point

Fixing broken build

LookupListener demo

Showing use of service loader

MockServices

Lookup all and one in code

Project to show usage of lookup

support for download binaries from inside a build, tested on Lookup's JAR

Finished re-reading of "classes vs. interfaces"

Compute with added method converted to separate project

Finished review of "are abstract classes useful?", up to line 1600

Moving class based InstanceProvider to own project

Moving InstanceProvider into external sample files

Merge: Patrick's comments from Mar22

more polishing after the re-org

Fixed "Give creator more rights"

Extracting Hello example to real sources

Making the docbook compilable

Using code snippets from real sources to demonstrate the subclassing vs. delegation

As the purpose of buffer is to "buffer", let's modify our example to delegate to appendable methods directly only if the appendable is too big

Tests rewritten to new version, just the Writer version 2.0 does not yet implement Appendable

Nonsubclassable Writer example

Reflection will save to world!

CrytoWriter and when it is broken

Useless imports

Demo for writer throwing an exception; and also writing out CD content

Converting the Writer delegation problem into real example

URLs in apifest chapter replaced with code snippets

Rewriting the infrastructure to use shared common.xml

Also second version of this class needs to be made public, otherwise nobody will be able to use this API

This class needs to be made public, otherwise nobody will be able to use this API

Making jtulach's projects compilable

Getting the solutions from the CVS, not just from the ZIP file

Including solutions till day 2

Adding samples from API fest to the repository, including pieces of their code in the document, not just links

Merge: Geertjan's changes up to 4500

up to line 4500

Showing picture and code that prevents vicious circle

Support for debugging, tests work as expected

Simplified to does not contain the friend API, instead the SPI is directly define by the API

Using real pieces of code the talk about bridges

Also adding the project config file

Switching to freeform project

Repackaging to org.apidesign packages

Tests rename to describe the intention, e.g. new -> old bridge and vice versa, and modified to include also a call that initializes the bridge

Providers are working back and forth, but it is necessary to find a place to register them all

Defining also the SPI and providing a test. The integration with java.security is still missing

making the delegation to the old API work without any problems

spi part

Attempt to show how to write bridge for MessageDigest

Integrating Geertjan's changes to 1/2 of the theory chapter

first changes

Merging yesterday's work from home

Write a note about these day's hot topic - master file system rewrite.

Trying to translate to English

A Czech note about the dialog in Enigma

Removing useless header comment

Merging with my yesterday's work home on consistency of an API

First paragraph about runtime aspects of an API

Using code snippets from the Lookup interface

Creating project to demonstrate problems with lookup inconsistencies

Removing useless import

Correcting the location of impl package

Better implementation of sumRange

How to write factorial

Really downloading junit from their site

Fixing the optimized 2.0 implementation and adding yet another test for factorial of 4

Tests can be executed

Script for downloading libraries

Converting to ant freeform script as it allows to demonstrate the amoeba effect

Test showing the misuse of the original class

Sample showing the danger of inheritance

Grammar fix.

Sample with configuration parameter to a factory

Adding interface or class into hierarchy is backward compatible

Using real example of bytecode patching

Example with bytecode patching

using info level for messages

constants demonstrated in real project

build script for version like project

example with conditional usage of an API

Rationalism

Merge

Accessor example is taken from real source code

Updated build files

build files should not be ignored

Adding friend access example