Wednesday, January 25, 2017

IDEs for editing LESS files / Semantic UI Themes

The thing I'm searching for is:

Code Intelligence for LESS files with the following features:
  • Go to definition across files
  • Find usages across files

I started my search for an appropriate tool from the Less reference for tools.

Stuff that does that:


Stuff that does not do that:

Thursday, January 19, 2017

CSS: box-sizing: content-box vs border-box


Sources: http://www.w3schools.com/cssref/css3_pr_box-sizing.asp | https://css-tricks.com/box-sizing/ | http://www.binvisions.com/articles/box-sizing-property-difference-content-border/

Box-sizing

  • content-box
    • Default. 
    • Width or height = content's width or height. Border, padding, or margin are not included
  • border-box
    • Width or height = content + padding + border width or height. Margin is not included.
  • initial
    • Sets this property to its default value.
  • inherit
    • Inherits this property from its parent element.


Wednesday, January 18, 2017

CSS position: static, relative, absolute and fixed

Sources: W3Schools CSS Layout - The position Property | CSS Tricks Absolute, Relative, Fixed Positioning: How Do They Differ?

  • Static
    • The default. Positioned according to the normal flow of the page.
    • Not affected by the top, bottom, left, and right or z-index properties.
    • It is useful when you forcefully want to remove some other positioning that was applied to the element outside of your control.
  • Relative
    • "Relative to itself". Relative to as if it were positioned as static.
    • Affected by the top, bottom, left, right and z-index properties.
    • Other content will not be adjusted to fit into any gap left by the element.
    • Limits the scope of absolutely positioned child elements.

  • Absolute
    • Positioned relative to the nearest non-static positioned ancestor, or the body if there are no such ancestors. 
    • Affected by the top, bottom, left, right and z-index properties. 
    • Does not leave a gap in the page where it would normally have been located.
    • Does not affect the position of any other same-level element

  • Fixed
    • Positioned relative to the viewport (or window), which means it always stays in the same place even if the page is scrolled.
    • Affected by the top, bottom, left, right and z-index properties. 
    • Does not leave a gap in the page where it would normally have been located.
    • The downside of this element is the usability on different screen-sizes. It does not scroll, so if it does not fit the screen, the content is cropped and unreachable.

GIT: the difference between HEAD~1 and HEAD^1

Source: Stackoverflow --> git-rev-parse manual page

^N: Nth parent of the tip of the current branch.
~N: Nth generation first parent of the tip of the current branch.
Here is an illustration, by Jon Loeliger. Both commit nodes B and C are parents of commit node A. Parent commits are ordered left-to-right.

G   H   I   J
 \ /     \ /
  D   E   F
   \  |  / \
    \ | /   |
     \|/    |
      B     C
       \   /
        \ /
         A
A =      = A^0
B = A^   = A^1     = A~1
C = A^2  = A^2
D = A^^  = A^1^1   = A~2
E = B^2  = A^^2
F = B^3  = A^^3
G = A^^^ = A^1^1^1 = A~3
H = D^2  = B^^2    = A^^^2  = A~2^2
I = F^   = B^3^    = A^^3^
J = F^2  = B^3^2   = A^^3^2
(emphasis by me)

Tuesday, January 17, 2017

Force LF line endings on Windows with GIT

The possible git settings for line endings are:

  • Checkout Windows-style, commit Unix-style
    Git will convert LF to CRLF when checking out text files. When committing text files, CRLF will be converted to LF.
    Git will not perform any conversion when checking out text files. When committing text files, CRLF will be converted to LF.
    Git will not perform any conversions when checking out or committing text files. 
    git config --global core.autocrlf true
  • Checkout as-is, commit Unix-style
    git config --global core.autocrlf input
  • Checkout as-is, commit as-is
    git config --global core.autocrlf false

Solution on Stackoverflow:

The proper way to get LF endings in Windows is to first set core.autocrlf to false:
git config --global core.autocrlf false
Now git won’t do any line ending normalization.
If you want files you check in to be normalized, do this:
Set text=auto in your .gitattributes for all files:
* text=auto
And set core.eol to lf:
git config --global core.eol lf
Now you can also switch single repos to crlf (in the working directory!) by running
git config core.eol crlf
After you have done the configuration, you might want git to normalize all the files in the repo. To do this, go to to the root of your repo and run these commands:
git rm --cached -rf .
git diff --cached --name-only -z | xargs -n 50 -0 git add -f
If you now wano also normalize the files in your working directory, run these commands:
git ls-files -z | xargs -0 rm
git checkout .

Personal opinion: 
I set core.autocrlf to input, to make sure that the repo gets LF line endings always.

Friday, October 14, 2016

Processing custom object from html form data of JSON from a POST request with JAX-RS

The main concept is, that if your Java bean class implements the Serializable interface than JAX-RS supports conversion from and to JSON out of the box.
So I would expect something like this to work:
@POST
@Consumes(MediaType.APPLICATION_FORM_URLENCODED) // this is the "application/x-www-form-urlencoded" media type.
public void processFeedback(@FormParam("feedback") Feedback feedback) {
 this.feedback = feedback;
}
However, with @FormParam this does not seem to work for me.
I get this error:
Caused by: java.lang.RuntimeException: RESTEASY003875: Unable to find a constructor that takes a String param or a valueOf() or fromString() method for javax.ws.rs.FormParam("feedback") on public void my.app.FeedbackEndpoint.processFeedback(my.app.Feedback) for basetype: my.app.Feedback
The solution is to do implement one of the required ways of instantiating the class, so
  • a constructor that takes a String parameter, or
  • a static valueOf() method, or
  • a static fromString() method

Monday, September 26, 2016

Mercurial Hg - frequently used commands

hg clone
copy a locally non-existent repository from remote repository
hg pull --rebase
pull changes from remote to local, rebase local commits on new head
hg pull -u
pull changes from remote to local, update working dir to new head
hg update [optionally: where]
updates working dir to head or specified revision
hg st
hg status
list status of the working directory
hg commit
commit changes
hg commit --amend
amend last commit
hg push
push to remote repository
hg rebase -s [what] -d [where]
rebase one commit and its children to another commit -- commits specified by [commit number]
hg strip --keep [what and its children]
remove a commit and its children, and keep the changes in the working directory
hg strip [what and its children]
delete a commit and its children (will not keep changes!)
hg purge
cleans the working directory
hg shelve
hg unshelve
shelve or unshelve changes in the working directory