Project   Frame4J   —   a Java framework

Frame4J is a powerful infrastructure to build

• standalone and distributed
• applications and tools.

[ download | repository | install | documentation / tools | on Pi | GIT issue ]

Frame4J provides

• the fundamental infrastructure for applications
  • I/O handling, logging,
  • properties, parameters,
  • language support.
• comfortable and fast String handling,
• some math support: algorithms, points, complex numbers ..
• time and date handling, extended parsing, ..

and it also brings

• a bundle of ready made tools for
  • developers and
  • administrators of web sites, domains and repositories.

These tools are explicitly suitable for automated (batch) use, also on remote servers. Applications build professionally upon Frame4J are

• comfortable,
• (inter) nationalisable,
• usable in critical infrastructures,
• and used so in 24h*7d process control applications for over 18 years.

Frame4J tools and Frame4J based applications provide (almost) the same behaviour from Windows Server 2003 (and before) to Win10 and on many Linux platforms. This stability, compatibility and (partly astonishing) platform independence are, of course, made possible by exact those virtues of Java from 1.2 to 8.
 

As mentioned Frame4J is an open source project. Project owner is Albrecht Weinert.   Co-workers are welcome — take part.
 

Status / history

September 2016: We had a jump in SVN revision numbering from about 160 backwards to ~4. SVN server [sic!] bugs forced relaunches of some repositories including Frame4J’s.
And we updated to the last non-commercial itext jars — the same as used by Michael Schierl’s jpdftweak.

August 2016: Major rework / refactoring to

1. )   exploit more Java8 features and improvements,
2. )   to reduce Frame4J's size and
3. )   prepare it for Java9's modularisation (never used).

The first and most obvious change is the removal of the time and date types

• ConstTime, Time,
• TimeRO and TimeST

from package de.frame4j.util. For more than a decade, those have been, of course, much more than a replacement for the horrible java.util time types. But now, much of their benefits were taken to Java8’s java.time package. Frame4J’s better parsing and formatting (with PHP like format symbols) were kept.
Now, TimeHelper helps Java8 time, too. TimeHelper and some new types to improve and support Clock are now found in de.frame4j.time (not ..util).
All (but two) deprecated classes were removed, as was the use of types deprecated in Java8 or to be deprecated in Java9.
rev165 is the youngest version before this conversion. Use this is situations were backward compatibility (e.g. Applet support) is required.
rev186 is the first version afterwards to be used in automated remote server applications. Use this or newer for new missions or development.

February 2016: On February 4th, as root CA, German Telekom revoked next level DFN certificate PCA Global - G01, serial number 9912441563214940059. It would otherwise be valid until July 2019 — and its direct or indirect signatures even beyond that date.
A revocation immediately invalidates all that.
Two levels deeper Albrecht Weinert’s certificate and all signed with it is affected. Especially this concerns Frame4J below revision 146.
Revision 147, February 26th 2016, Implementation-Version: 1.11.02, has been signed with a certificate based on valid ones.

Warning: Former versions will probably be good at local installations; r145 is the youngest version with the revocated certificate. r<=145 will almost certainly fail in the context of JNLP, WebStart and the like.
You would see a java.security.cert.CertificateRevokedException: Certificate has been revoked, revocation date: Thu Feb 04 13:47:35 CET 2016, authority: CN=Deutsche Telekom Root CA 2 …

Remark: As of now (Dec. 2020) no code signing certificate with a reasonable price and handling for our purposes is in sight. The domain certificate for frame4j.de cannot be used to sign package de.frame4j (and below) as lets encrypt won’t add that feature.

Spring 2015: Java8_0_40 deprecates installed extensions. Oracle announces to incompatibly drop them with Java9.
From November 2015 until now no real, i.e. working, robust and testable, migrating recipe has been presented.
"Make a module and bundle the libraries with the [one] application" won’t do. Frame4J is a framework

• some 15 applications which are available by just having Frame4J installed. Those tools are widely used on own and customers’ servers for automated processes, for example in SVN hooks, since years.
  Breaking this "Java standard deployment procedure" (since Java1.2, 1998) would hit Frame4J and many other projects.
  Perhaps we will have to climb on the jiggsaw / modularisation bandwagon as soon as all world will do so. Since November 2018 we have an adaption to use all Frame4J tools with Java 11 (w/o jigsaw except those requiring proven installed .jars like pfd or RS232/485/usb handling).
  Until now (Dec. 2020) we have Java8 as standard on (big) Windows (1.8.0_232) and on little Linux (1.8.0_212) machines.

November 2014 we started with using Java8 only for development and deploying. With beginning of 2015 we stopped using and supporting Java 7 and below. That includes the using Java8 features and starting to reduce those parts of frame4j.de that were motivated by pre8 bugs — like time, calendar and more.

November 2012 all Tomcat / Catalina related classes were removed. It was in the end impractical to bridge Tomcat’s code breaking changes in one deployment. Many older Tomcat servers ran on for long time with a suitably old frame4j.jar.

February 2010: Oracle announced Kenai’s shutdown and Frame4J moved to weinert-automation founded by Albrecht Weinert that year.

March 2009 saw the first successful port of a long run automation (process control) application from the predecessor "aweinertbib" to Frame4J.

November 2008: Frame4J is open source and one of the very first projects at SUN’s open software platform K≡nai. The software is open but the platform was not. A tight submission process had to be undergone to get a project. But, alas, … see February 2010 above.

Aims, Strategies

Frame4J is developed on base of the approved predecessor. Both did and do run control / server applications trouble free over many years in uninterrupted 24h7d.

• Hence, backward compatibility is and was important for Frame4J and as it was for Java. Notwithstanding the following breaking changes were made with respect to the predecessor (2007):
  • English only (javaDoc, comments, names) instead of German (except for one banking package used for online transactions available in German speaking countries only)
  • base package mainly de.frame4j (instead of de.a_weinert)
  • using Java8 features (2015) (with no return ...) and in consequence
  Since August 2016 this last incompatible conversion was, consequently, driven further; see above.
  For major and minor incompatible breaks, the last revision before will be kept some years for comfortable download.
• Frame4J shall be to a large degree JUnit tested / test driven
• Frame4J conforms to good design rules and the "Guideline for the usage of OO programming in critical systems", (an EWICS TC7 project).
• Frame4J was, is and shall stay a stable consistent and platform independent framwork and toolbox. It is easily available by just making frame4j.jar an installed extension.

[ download | repository | install | documentation / tools | on Pi | GIT issue ]