Thursday, May 4, 2017

Swift Initializers Delegating to Superclass Initializers

I was reading the swift 3.0 language specification and came across the situation defining how superclass initializers (constructors) must be invoked from subclass initializers:

“A designated initializer for that class confirms that all stored properties introduced by that class have a value. The memory for these stored properties is now initialized.The designated initializer hands off to a superclass initializer to perform the same task for its own stored properties.”
Excerpt From: Apple Inc. “The Swift Programming Language (Swift 3.0.1).” iBooks. https://itun.es/us/jEUH0.l
Initially, I thought it was odd that the subclass initialized itself, then the superclass was allowed to do so.  It seems that the superclass should go first since there is no connection from the super to the sub, since it was defined independently.  Consider this example though:

class sup
{
init()
{
callMe();
}
func callMe()
{
print("0");
}
}

class sub : sup
{
var n: Int;
override init()
{
n = 1;
super.init();
}
override func callMe()
{
print("\(n)");
}
}

What I forgot about is that the superclass initializer, once it has initialized all of it's properties, is allowed to call methods which could be overridden by the subclass.  If the subclass tries to call an inherited method, the compiler disallows that:

class sub : sup
{
var n: Int;
override init()
{
n = 1;
callMe();
super.init();
}
override func callMe()
{
print("\(n)");
}
}

Playground execution failed: error: SwiftInits.playground:93:3: error: use of 'self' in method call 'callMe' before super.init initializes self
callMe();

So, this is the order:

  1. Subclass initializer is called
  2. Subclass properties are all set
  3. Superclass Initializer is called.
  4. Instance methods may be called on subclass.
In the case where a class is being constructed without an explicit superclass, the same applies without step (3).  In Java step 3 is always the Object constructor so the process is the same (implicit call versus explicit call).

Java requires that the superclass constructor call must be the first line of any constructor body, and is implicitly done if not explicitly called.  Here is a similar example in Java:


class sp {
 sp()
 {
  int i = callMe(); }

 int callMe()
 {
  return 0; }
}

class sb extends sp
{
 private int n; sb()
 {
  super();  n = 1;  int i = callMe(); }

 int callMe()
 {
  return n; }

}

The way Java handles this situation is to restrict the superclass constructor from calling subclass methods.  The call to callMe in the superclass constructor actually calls the superclass version, not the subclass version.  I think the swift approach is simpler.

So, thinking about it in more detail, it makes sense.

Tuesday, November 22, 2016

When They is appropriate. ?

“If an owner participates in the first set, they can make an election, rather than being forced to either participate or relinquish their interests,” Johnny said. “It also protects the rights of small producers by giving them unprecedented safeguards.”

I suppose there is no point anymore in getting upset about how the pronouns 'them', 'they', 'their' and 'theirs' have been shoehorned into the singular neuter tense as well as plural neuter.  Historically, those pronouns have always been reserved for the plural case, but since English only contains 'it' as singular neuter, and English speakers do not like being called 'it', we are stuck with resorting to 'them', 'they' and 'their' when we don't want to say 'he' or 'she' without a definite male or female subject.  This can be done without borrowing, of course,  with the ubiquitous but disruptive he/she (she/he).  In most other cases, though, a rewrite is needed in order to convey the idea naturally.  The first sentence above, for example, can be repaired by making everything agree:

“If owners participate in the first set, they can make an election, rather than being forced to either participate or relinquish their interests.”

Now all verbs and subjects agree.  Why did the original writer not do this?  I do not know.  Maybe because of laziness, or because an editor caught the phrases "he can make an election", and "relinquish his interests" and changed them to "they can make an election", and "relinquish their interests", without considering the entire sentence. The second sentence, for whatever reason, is consistent - probably by accident since they were both written by the same author in the same paragraph.

At any rate, the handwriting seems to be on the wall.  Over the next 50 years or so, we will have changed pronoun behaviors:

  • I am
  • you are
  • he/she/it/they is
  • we are
  • you are
  • they are
I find this grotesque and unnecessary, especially since it is driven by political correctness, but that is where our language appears to be going.  Furthermore, those who safeguard the language - writers - seem to be driving the change.

:|

A Pragmatic View of Looping Constructs in Swift 3.0

As most developers who use Swift are probably aware, the traditional 'C-Style' for-loop has been deprecated - and outright disdained - in version 3.0 of the language.  A prototypical example follows:

Ex 1:
for (int i = 0; i < 100; i++)
{
// Whatever meaningful thing needs to be done 100 times

}

In Swift 2.x, this syntax is discouraged, but in Swift 3.0 it is removed altogether.  Now, in the Swift language manual, Apple explains how this can be accomplished in modern syntax:

Ex 2a - exclusive end index (does not include 100):
for i in 0 ..< 100
{
print(i);

}

Ex 2b - inclusive end index (includes 100):
for i in 0 ... 100
{
print(i);

}

That about does it for our trivial example.  Almost every real-world usage is more complex than this so I wanted to delve into those scenarios for the sake of other developers (and myself once I have forgotten).  First off, there is the incrementer expression ('i++' in Example 1).  In Java, I often write an incrementer other than i++:

Ex 3:
for (int i = 0; i < 100; i += 2)
{
// Whatever meaningful thing needs to be done 50 times

}

There is a straightforward answer for this:  The where clause:

Ex 4a - exlcusive end index:
for i in ..< 100 where i % 2 == 0
{
print(i);
}

Ex 4b - inclusive end index:
for i in ... 100 where i % 2 == 0
{
print(i);
}

The downside of the where clause is that the runtime still counts all the values that don't match the where clause.  I.E., in the loop in Ex 4 the runtime follows this process:

0:  Initialize i to 0.
1:  Evaluate where clause.  If False skip to step 3:
2:  print i (Loop body)
3:  Increment i by 1.
4:  Is i < 100?  If so go to 1:

So, if your loop skips a lot of steps, or in other words uses a large increment, then this would waste a lot of cycles.  But, take heart, there is an answer for this as well:  stride.

Ex 6a - exclusive end index:
for i in stride(from: 0, to: 100, by: 2)
{
print(i);
}

Ex 6b - inclusive end index:
for i in stride(from: 0, through: 100, by: 2)
{
print(i);
}

The stride function actually returns a struct that serves as an iterator, so there is likely no allocation of memory since this can easily be accomplished in 1 variable.  However, what about the case where you need to access not only the current value of the loop, but also the index within the loop itself?  E.G., the loop in Ex 6a might have an i value of 2, but the loop index is 1.  This is accomplished using the enumerated function:

Ex 7:
for (index, j) in stride(from: 0, to: 100, by: 2).enumerated()
{
print("\(index): \(j)");
}

The enumerated function returns an iterable set of tuples, and according to the names you provide will contain the loop index as the first variable name and the array value in the second name.  In other words, the declaration in Ex 7 might as well be (Laurel, Hardy) as (index, j).  In that case, Laurel would be my index and Hardy would contain the value.  The order matters, not the labels.

In order to use enumerated, you have to be working with an object of some sort, either a Strideable as in Ex 7, or else some other appropriate type such as an array, as in Ex 8, but it can't be a plain numeric range:

Ex 8:
let arr: [Int] = [0, 2, 4, 6, 8];

for (index, j) in arr.enumerated()
{
print("\(index): \(j)");
}

Reverse loops are something I have really not ever had much need of (reverse counting loops).  For reverse counting, I usually use an upward counting loop with a calculation for the downward counting value.  Nonetheless, these can be accomplished in many of the same ways except that it always requires a more complex interaction over the traditional loop:

Ex 9 - simple reverse iteration:
for i in (0 ..< 100).reversed()
{
print(i);
}

Ex 10 - simple reverse iteration with where:
for i in (0 ..< 100).reversed() where i % 2 == 0
{
print(i);
}

Ex 11 - simple reverse iteration with index:
for (index, i) in (0 ..< 100).reversed().enumerated()
{
print(i);
}

Ex 12 - reverse iteration with stride:
for i in stride(from: 0, to: 100, by: 1).reversed()
{
print(i);
}

Ex 13 - reverse iteration with stride and index:
for (index, i) in stride(from: 0, to: 100, by: 1).reversed().enumerated()
{
print(i);
}

Ex 14 - reverse iteration with stride and a negative increment.  May not be 'proper', but it works:
for i in stride(from: 100, to: 0, by: -1)
{
print(i);
}

"Wait", you say, "What about the case where I have to loop with . . . <blah> <blah> <blah> <some special circumstance>???!?"  There is always some special circumstance which can't be accounted for in the language itself without making everything too complicated.  The fallback answer is the trusty while loop:

Ex 15 - loop starting with my Aunts' age, skip 17039 days until you reach my julian birth date
let julianBirthday = 2440131;
let myAuntsAge = 31;
let unusualInterval = 17039;

var loopIndex = 0;
var counter = myAuntsAge;

while(counter < julianBirthday)
{
print("\(loopIndex): \(counter)");
counter += unusualInterval;
loopIndex += 1;
}

Ex 15, besides being completely useless, demonstrates that the basic while loop is much more tedious to build but contains enough to handle just about any situation.  It is also not a very good example, because it can be written using the simplified versions:

Ex 16 - our loop was really not that special:
for (loopIndex, counter) in stride(from: myAuntsAge, to: julianBirthday, by: unusualInterval).enumerated()
{
print("\(loopIndex): \(counter)");
}

Wednesday, February 24, 2016

Swift asserttions

I just ran across this today.  It's pretty cool - assertions in swift can be implemented using a closure shorthand which runs efficiently.

Saturday, November 28, 2015

(Im)Proper way to end an iOS app . . .

I am very new to Swift and iOS programming in general, and I had a situation where I wanted to throw an exception to fail an app in an unacceptable situation, and all I knew to do was to call exit(1) in plain old C-fashion.  I put that in my code like on the first day, and I forgot about it.  Since then I have had a lot of bizarre problems with XCode like not running my tests and just logging weird errors like "Failed to bootstrap" and other things.  I finally figured out that was what was causing the errors, and instead I could use:


    fatalError(@autoclosure message: () -> String = default, file: StaticString = default, line: UInt = default)

E.G.

   fatalError("You did something dumb.");

and it accomplishes the same thing (tells me I have done something stupid), but now the debugger stops on that line of code so I remember exactly what I have done.

exit(int), don't use it.

By the way, this is something that only a developer could do, clearly this would not be the way to handle an unexpected user condition.

Tuesday, November 24, 2015

Preach it, brother.

I came across this post today.


I especially like this:  “There is a fundamental difference between the few developers that will become highly skilled and all the other copy and paste developers. The former know they lack knowledge and take the time to grow it. The latter never bother, they go on with what little they know, trying to hack together something and calling it a day.”

Life can be frustrating as a dig-in-and-find-out-how-it-works developer, but I have always admired someone who will dig into something, endure the frustration and "What were they thinking???!?" moments, and come out on the other side with an actual understanding of how something works.

Wednesday, November 4, 2015

Swift Protocol-Oriented programming

Apple makes a big deal about Protocols in swift and how they are better than anything else ever.  I found it quite irritating that nowhere in their explanation of what makes them so great did they mention that a protocol is eerily similar to an interface in Java.  Moving from a C++ background to Java, I was completely baffled why you would use an interface rather than an abstract class.  That question was answered back in 1997 when I started designing applications and APIs using interfaces first.  Nowadays, moving into swift, protocols certainly have features that interfaces do not - such as extensions and conditional conformance - but really - this is not something they just pulled out of nowhere.  I wish they didn't have to act like every thing they do is new and unprecedented.

It would be so much more honest for them to come out and say, "In designing a new language, we looked at what works in Java, Lisp, Python, (gasp) Perl, Haskell, Go, JavaScript - the needs of iOS and the environment apps find themselves in - and created a best-of-breed language."

Swift 2.0, Reference and Value Types, and Unintended Sharing.

I have recently begun learning swift 2.0, because I would like to build an iOS app and I really don't want to have to learn Objective-C.  I am trying to learn it the right way, which means understanding how the language works and not just mutating examples to learn by accident.

I have been reading a lot about structs and classes, and the difference between value types and reference types.  In short, classes pass around object references and structs make copies whenever you pass them around.  I visualize it in old-school terms:  Classes use pointers, but with structs the variable IS the data.

This seems pretty simple - especially if you are comfortable with object languages.  I have watched a few Apple videos, though, and they make it sound revolutionary.  This one in particular goes on about unintended sharing - I pass a handle to the same object into two different contexts where they are expected to be independent.  Change one, impact the other, etc.  His illustrative example was "I created a thermostat object, assigned it to my house.  Then I set the thermostat in my oven to 450, and my house caught on fire!"  Paraphrase.  Gag - what a juvenile way to introduce a language feature.  They could have at least used a real-world scenario they came across implementing their standard libraries that made this feature such a deal-maker.

This seems to me to be very valuable to a college student, or someone learning an object language coming from C, but really, is this that big of a deal?  I can honestly say that I haven't had a bug of this type in my code, that I have detected of course - for decades.  On the other hand, I just spent an agonizing couple of days trying to figure out why extremely routine code did not work.  Take this example:

var map = [String: [String: String]]();
var subMap = [String: String]();
map["map"] = subMap;

subMap["1"] = "2";

For those who don't know swift, this means create a map which can hold maps of string value/pairs.  Next, create a string value/pair map, and assign it to the key "map" in the top-level map.  Finally, assign the key/value entry "1" -> "2" into the sub map.  The expectation being that it will be reflected in the top-level map as well.  This is pretty standard in Java - I do it a lot so I can factor code which handles the sub trees into external code.  In this case, it doesn't work.  Because collections in swift are structs - I.E., value types - the assignment on the third line makes a copy which is unaffected by the assignment on line 4.  I came up with this working code after much hair-pulling:

var map: Dictionary = [String: [String: String]]();
map["map"]!["1"] = "2";

And only later uncovered the reason that I explained before.  I find this extremely annoying, but certainly manageable once you understand the language - and maybe even something you can use effectively.  But I found his example so contrived that I basically checked out.

Wednesday, July 29, 2015

Java FX Event Thread vs AWT Event Thread Brawl

So, I recently started working on a Java UI application focussing on my backend first, then the UI components.  I am not very good at making pretty swing UIs (very out of practice - but I was really active when Swing was in development - what was that, 1997?  :| ).  I have done a lot have dynamic web development over the last decade and am frankly shocked that swing UIs are so far behind.  A dynamic swing UI to match a trivial web interface would be a LOT of work.  So, my first cut at my UI was targeted at behavior and testing, which was a substantial effort - I would have thought automated unit testing in the user interface would be in a better state than it is.

Almost every substantive UI testing platform appears to be abandoned (uispec4j, abbott, others I can't remember anymore) so I decided to build my own support as I needed it (Not building a generified UI unit testing framework - just what I needed).  The one good thing that came out of this approach was I realized testing the UI through the UI - as a user would or a record/playback testing method - was a big mistake.  I was decomposing my user interface as any good developer would do, but my testing was completely monolithic.  Instead, I started testing components at the finest grain and my tests became so much faster and easier to write with less bulk.  I also wired components together to rely on messages between objects rather than having handles to each other.  Sound familiar?  That should have been my approach from the start.

At any rate, I was going along, and decided it was time to make the user interface better, and I thought it might be time to look at Java FX.  One of the major factors was Oracle choosing FX as the future direction for java, but also the ease with which you can externalize the building of the user interface into fxml files.  That is huge.  I can use a builder and not be tied to a tool like eclipse or IntelliJ - big win.

I made a refactor which permitted me to transition from swing to Java FX as it seemed desirable, and even encouraged with the addition of JFXPanel.  This seemed ideal since rewriting the entire UI all at once sucks.  Well, this sucks worse.  The Java FX Event thread and AWT Event thread are entirely incompatible - so threading in the UI is a nightmare.  Consider as an example a Swing Button action handler which needs to update the state of an FX node - you would have to do that asynchronously, you can't call PlatformImpl.runAndWait from the AWT event thread - it will hang a lot of the time.  But if your button action handler needs to wait until the FX node is complete updating - such as if the update triggers another event handler - you have to do it all asynchronously with a lot of calls back and forth into the different event threads and you are left with a real mess.

To compensate - I have had to convert all messaging in the GUI to asynchronous - which makes unit testing a major hassle because obviously test code needs to wait until things are done before making assertions.  The bottom line to me is not to do this.  Transitioning to Java FX should be done at least at the Frame level - or Stage in Java FX parlance - and don't let messaging in the GUI depend on passing between the different systems.

Tuesday, June 16, 2015

Maven dependency ranges must die!

When I first read about the capability of maven to loosely depend on an artifact using version ranges, I thought, "Wow, that's pretty cool!  Why doesn't everyone do that?"  After all, who wouldn't want the latest version of newly released awesomeness?  By way of example, this is how a dependency in maven usually looks, excerpted from Stefan Birkner's excellent JUnit system rules project:

<dependency>
<groupId>com.github.stefanbirkner</groupId>
<artifactId>fishbowl</artifactId>
<version>[1.1.1]</version>
<scope>test</scope>
</dependency>

This means your project depends on version 1.1.1, exactly, of something known as fishbowl in the group of things known as com.github.stefanbirkner.  The brackets around the version number are not usual, and are in fact redundant since they specify the same thing as <version>1.1.1</version> - that version and that version alone.  Going on further in the pom, we find this:

<dependency>
<groupId>junit</groupId>
<artifactId>junit-dep</artifactId>
<version>[4.9,)</version>
</dependency>

This construct is altogether different.  It specifies a dependency on the artifact known as junit in the group known as junit, but allows for any version greater than or equal to 4.9.  The bracket on the left is an inclusive operator and the parenthesis on the right is an exclusive operator.  The comma allows for any later revision.  By way of example, (4.9,5.0) would mean any version after but not including 4.9 but before and not including 5.0, and (4.9) would mean any version greater than and less than 4.9.  That wouldn't work at all.

This seems pretty powerful, but . . .

I have recently come 180° in my thinking about this.  I now hate them with a passion - for two very good reasons.

Awesome Reason I

This one is purely idealogical, which is not to say that it is without merit, it's just a caveat that it may be debatable.  If you depend, for instance, on apache commons-io 2.3, what reason do you have to expect it to work with 2.4?  Or even 2.3.1?  What assurances do you have from that developer community that 2.3.1 will not introduce a bug which impacts your library?  Certainly by version 2.4 the API might change and break compatibility with your code.  This is unpredictable and should not be part of a stable, release build.

Awesome Reason II++

This one is the biggie, and also exceedingly pragmatic.  The aforementioned system rules library, which while otherwise awesome, includes a dependency on junit 4.9 and onwards.  In a practical sense, though, depending on system-rules exposes my builds to periodic failures that are very difficult to track down or diagnose.  Just today I got this error again:

[ERROR] Failed to execute goal on project ssc-cli: Could not resolve dependencies for project org.bitbucket.bradleysmithllc.star-schema-commander:ssc-cli:jar:ssc.1.C: Failed to collect dependencies at com.github.stefanbirkner:system-rules:jar:1.9.0 -> junit:junit-dep:jar:[4.9,): No versions available for junit:junit-dep:jar:[4.9,) within specified range -> [Help 1]

What does this mean?  Why is it happening?  Well, after being plagued with this for a long time, I finally tracked it down.  Some transitive dependency of my project keeps retrieving crapped-up versions of junit, in this case 4.11-beta-1, which satisfies the dependency to be greater than or equal to 4.9, but is not an actual release - it is something that made it to central and then somehow into my repository.  My only (reasonable) recourse is to go to my local repository and delete the junit group tree (~/.m2/repository/junit) and rebuild.  Guess what happens next?

[ERROR] Failed to execute goal on project ssc-cli: Could not resolve dependencies for project org.bitbucket.bradleysmithllc.star-schema-commander:ssc-cli:jar:ssc.1.C: Failed to collect dependencies at com.github.stefanbirkner:system-rules:jar:1.9.0 -> commons-io:commons-io:jar:[2.0,): No versions available for commons-io:commons-io:jar:[2.0,) within specified range -> [Help 1]

Yep, you guessed it - another broken dependency range - this time apache commons-io.  Repeating the same process, I delete my cached commons-io artifacts (~/.m2/repository/commons-io) and now my project builds.

I do not know why exactly this keeps happening - and I am sure that there are many things that could be done to fix it - like track down bad dependencies and fix everyone else's poms, but that isn't an option in most cases nor is it even something I want to do.  My project has an explicit dependency on junit 4.11, which satisfies >= 4.9, so I don't know why it would consider any other version.  The bottom line is that there is no way to predict when a library will break compatibility with yours, and you should not try to anticipate when that will happen.  Builds must be stable and reproducible, and dependency ranges violate both of those goals.

Friday, June 5, 2015

Snob overflow . . .

Okay, another one of my many pet peeves. When people ask questions to Stack Overflow, the community often incorrectly assumes that you are too stupid to ask a real question and instead talks down to you and won't give a straight answer, even if there is one.

Here is a case-in-point: how-to-release-all-permits-for-a-java-semaphore

The question was immediately met with contempt: "What do you need this piece of code for?". This question was not asked for clarification, but so that the discussion could go in a completely different direction. The Stack Overflow moderators are such Nazis about intervening: "This is not a question!", "This is a survey!", "These are opinions!", "This is a duplicate!" - that I am surprised they don't get upset in this situation, because you have a clear question posed, and the selected answer goes in a completely different direction. Rather than answering the question "How to release all permits for a Java Semaphore", they answered the question "How do I better design my code to keep my thread pool in sync?"

The simple answer is:

semaphore.drainPermits();
semaphore.release(totalNumPermits);

Again, whether that discussion is valuable or not, it does not answer the very straightforward question that was asked.

Friday, May 8, 2015

Sonic, What's up with your foam cups??

I have been noticing for the past few months that my Route 44 styrofoam cups from Sonic in OKC have the annoying 'feature' that they leak through the pores in the foam. I have noticed this many times - and is it ever annoying. Here is a sample from the cup I am using right now. This cup is probably two or three days old, picked up at the Bricktown Sonic:
Those little drops look like normal condensation, but they are actually water escaping through the cup. I have to keep a paper towel under my drink at all times or else my desk will be all wet. In years past I could keep the cups for a long time and this would not happen. Very strange and not a little annoying.

Monday, May 4, 2015

Java Synchronization. What's the big deal?

Throughout my career as a Java developer, I have read a non-trivial amount of code related to minimizing the impact of synchronized code blocks.  The topic of thread safety is extremely complex, and must be embarked upon carefully.  In some cases, just declaring lack of thread safety can simplify a project immensely, E.G., java swing, but there are times when it can't be avoided without introducing a lot of complexity on the other side of the API.  That's not what I am referring to, however.  Consider double-checked locking.  This technique is often used simply to reduce the amount of time it takes to call an accessor.  To illustrate, I wrote the following chunk of code:

import java.math.BigDecimal;
public class Main {
 public static final long TEST_COUNT = 1000000000L;
 public static void main(String[] args) {
 long r = 0;
 long startSync = System.currentTimeMillis();
 for (long i = 0; i < TEST_COUNT; i++)
 {
 r += getSync();
 }
 long stopSync = System.currentTimeMillis();
 long startUnsync = System.currentTimeMillis();
 for (long i = 0; i < TEST_COUNT; i++)
 {
 r += getUnSynch();
 }
 long stopUnsync = System.currentTimeMillis();
 BigDecimal syncTotal = new BigDecimal(stopSync - startSync);
 System.out.println("Sync took (" + syncTotal + ") ms., or (" + (syncTotal.divide(new BigDecimal(TEST_COUNT)).multiply(new BigDecimal(1000))) + ") microseconds average.");
 BigDecimal unsyncTotal = new BigDecimal(stopUnsync - startUnsync);
 System.out.println("Unsync took (" + unsyncTotal + ") ms., or (" + (unsyncTotal.divide(new BigDecimal(TEST_COUNT)).multiply(new BigDecimal(1000))) + ") microseconds average.");
 }
 private static synchronized long getSync()
 {
 return System.currentTimeMillis() % 100L;
 }
 private static long getUnSynch()
 {
 return System.currentTimeMillis() % 100L;
 }
}

When I ran it, this was my output:
Sync took (98345) ms., or (0.098345000) microseconds average.
Unsync took (43530) ms., or (0.04353000) microseconds average.


The difference here is 50 or so nanoseconds per access. Unless you are writing a high-performance application like a 3D game or database, I just don't see how this can even be worth discussing. Almost every application I write would involve calling these accessors on creation, which means 40 or 50 times during an entire application life, or even if it is tied to user requests like in a service or web application, 50 microseconds per request will be dwarfed by the amount of time the request itself takes. If there is a database access, just opening a connection that takes 1 millisecond to open will be 20,000 times slower than a synchronized accessor.

As engineers we sometimes like to focus on the really fun stuff, like generated bytecode or network packets or even CPU states, but synchronization overhead doesn't even seem like it's worth the time to type out.

PS: Have I said how much I hate the blogger editor???

Friday, April 24, 2015

Star(schema) Commander, Iteration 4

So, thus far I have added groupings, aggregates and degenerate dimensions to the core, and I have added references to JxBrowser which added 200MB to the project. :(

The UI for the data explorer is challenging.  I don't want to spend the rest of my life on it but I also don't want to produce an ugly piece of crap reminiscent of old Linux Motif/Tcl/Tk apps.  The Java UI is much more limiting than I remembered - most new gestures aren't accounted for, even in the newest stuff.  Maybe JavaFX?

Sunday, March 29, 2015

Star(schema) Commander, Iteration 3

So much for micro releases.  :|

So far I have experienced a few interesting things:

  • Micro releases are not that satisfying when doing initial development - especially across three interconnected projects - core, cli and gui libraries.
  • Unit testing user interfaces really sucks.  I tried to find something but no solution seems to be around for very long.  In the end I created my own UI framework based on standalone components and messaging which made testing very easy and meant the runtime app just had to wire them together properly.  It also achieved a nice encapsulation of the different UI parts.
  • It is WAY too easy to get stuck testing every detail in a UI and it can eat up a LOT of time because everything you have to do is a new one-off.
  • The internet is not very helpful on the issue of user interface testing.  If I have to read another lecture about separation of responsibility and how you should test the domain layer, not the UI objects, blah blah barf, I will delete the internet.  Guess what, people? User interfaces have requirements as well and those must be tested with the same level of reliability as other parts.
  • When testing a user interface, there is a lot you have to let go.  Unit testing Java code can be very granular and specific, but if you try that in a user interface it will be a train-wreck.  E.G., if a table has headers that read "Name", and "Schema", testing those is going to add more semi-useless tests and will make any change to the UI break way too many tests.  Besides which I would like to refactor my UI (changing lists to tables, etc) without extra tests breaking.
  • I did manage to temper my desire to create the perfect user interface library.  I simply created what I needed and refactored as I realized that I needed more functionality.  There is a word for that but it escapes me at the moment (and most other times) ;)  . . .
  • I am toying with the idea of rewriting my UI using JxBrowser - a Java library for using an embedded Chromium container.  My Java desktop apps look so crappy and take so much work to wire together and are therefore resistant to change, and HTML makes a nice container for UI code - as compared to Java code.  I am concerned about the extreme commercial nature of the project - $1600 per license minimum; I don't know what they think they are providing that is worth that price - even if I do have a free open source license at my disposal.

Thursday, March 5, 2015

YAJUEHP - Yet Another JUnit Exception-Handling Post . . . *yawn*

I can't imagine anyone will find this useful when it is so tiresome to me, but after a jaunt in UI Testing purgatory I had to go back and test some plain old library code, but this time with a new twist.  I have been using the rather awesome ExpectedException class with nice results.  The Code Under Test in this case, however, threw InvocationTargetException's with wrapped cause's which made that approach too brittle.  I found this nice post about it which solved my issue:

JUNIT EXPECTEDEXCEPTION RULE: BEYOND BASICS

Toward the bottom there is a nice discussion of verifying causes.  I found another article he wrote comparing various exception strategies in JUnit here:

6 WAYS OF HANDLING EXCEPTIONS IN JUNIT. WHICH ONE TO CHOOSE?

I thought these were pretty handy - hopefully someone else will as well.

Wednesday, February 4, 2015

Star(schema) Commander, Iteration 2

I got version 1.1 and 1.2 out in the same night.  I have dimensions and reporting areas, and a mechanism to import dimensions from a database.  Not too useful yet, but facts are coming.

Saturday, January 24, 2015

JUnit System Rules

I found this today - it was very helpful for some testing I was doing.

System Rules

It has all kinds of cool stuff in it, but what I was looking for was a way to have tests override system properties (Specifically to test code which relied on user.home) and after each test completes the properties are restored.

Wednesday, January 21, 2015

Star(schema) Commander, Iteration 1

I have created an API, a maven project, and set it up for maven central synching.  That's not much value, but it is a lot of legwork.

For the next release I am going to aim for at least the ability to create a profile.

Tuesday, January 20, 2015

Star(schema) Commander, Iteration 0

Because I am constantly writing queries against dimensionally modeled star-schemas, I decided to write a small app to make the process easier.  I thought I would approach it in an agile manner - incorporating small releases and focussing on delivered value.

I also thought it might be interesting to post my experiences mainly to help keep myself on task.  My goal is to have a very usable UI - but I have tried that before and I think it will end up like a messy iOS app with code scattered all over user interface components.  It would also take a long time for me to be able to do anything meaningful - and an application opening a window is not value.  E.G., It might take months to make the UI work, but probably only a few weeks to have a command-line tool I can use to generate queries.  That would be a win by itself.

So, anyway, here I go.

This is the bitbucket project (currently blank):  https://bitbucket.org/bradleysmithllc/star-schema-commander

This is where I will actually document it (also currently blank): https://etlunit.atlassian.net/wiki/display/STAR/StarSchemaCommander