Knowledgebase Document

This repository contains an ongoing list of knowledge base items that I've learned over the years

Table of Contents

• Git Commands
• PHP
• SQL Statements
• Shell Scripting
• MongoDB
• Java
  • Intellij
  • Mockito
  • VS Code
  • Maven
  • Spring
    • REST
  • JPA/Hibernate
• Other
• Tivoli
• CSS
• Yarn
• Angular
• Azure DevOps

Git Commands

To reset origin master to a particular commit:

git checkout master
git reset --hard <commit_hash>
git push --force origin master

To query the git config and find out what config file it comes from:

git config -l --show-origin

To associate local branch to remote github repo:

1. Create a new repository on GitHub.
2. Open Git Bash.
3. Change the current working directory to your local project.
4. Initialize the local directory as a Git repository.

$ git init

5. Add the files in your new local repository. This stages them for the first commit.

$ git add . 6. Commit the files that you've staged in your local repository.

$ git commit -m "First commit"

7. At the top of your GitHub repository's Quick Setup page, click to copy the remote repository URL.

8. In the Command prompt, add the URL for the remote repository where your local repository will be pushed.

$ git remote add origin <remote repository URL>
# Sets the new remote
$ git remote -v
# Verifies the new remote URL

9. Push the changes in your local repository to GitHub.

$ git push origin master

If you are trying to locate some (remote) branch that was created by someone else recently and are not seeing it by using git branch -a, then make sure to run git fetch, which will pull down the metadata for any new branches created. Then you should be able to see the branch you're looking for.

If errors related to invalid proxy when trying to run git pull: From git bash, run “cd ~” to go to home dir and look for “.gitconfig” file. In there, you may have an [http] section with a proxy defined. To fix the problem, you have to edit or remove that.

How to list all the configuration for Git: git config --list

How to set VI as the editor for Git so that when pulling down new code I can have a chance to edit the commit message without opening VS Code: git config --global core.editor vim

How to make a branch from a tag: git checkout -b <new branch name> <tag name> git checkout -b hotfix-68 q2oNA-Q2O_NA_DEV_Deploy-68 To diff to branches excluding certain folders - in this case, I want to diff the master and current branch: git difftool master 4.6PricingWSDL -- . ':!java2ts' ':!jaxbWsdlProject'

to diff with the remote branch and show file names only: git diff --name-only master origin/master -- . ':!java2ts' ':!jaxbWsdlProject'

Here is a command to attach a local branch to an up-stream branch: git push --set-upstream origin remove-ibm-software

To test a merge with no commit: git merge --no-commit --no-ff remove-ibm-software

To remove a remote branch: git push origin --delete <remote branch name> for example: git push origin --delete remove-ibm-software

To see how far out of sync with origin/master: git fetch origin git diff --name-only origin/master

To diff a particular file with origin/master: git fetch origin git diff origin/master <directory path>/<file name> e.g. git diff origin/master q2oBusiness/src/com/blah/q2o/service/quoteservice/dao/model/DBLnvQuoteOrderHeader.java

Get a list of all deleted files: git log --diff-filter=D --summary | grep delete

Then in order to find out all the commits related to a specific file: git log --oneline --follow -- q2oBusiness/src/com/blah/q2o/service/parserservice/ibm/LenovoServicesXlsParser.java

To force a revert of changes (in the middle of a merge) back to HEAD git reset --hard HEAD

To put your local branch back to a particular commit: git reset --hard 029842e

To add and commit at same time

commit -am “My commit comment”

Check the status of your local working directory (see uncommitted files, etc) git status

Branches: What branch is active on your working directory: git branch

Change working directory to another branch: git checkout <branch name>

To create a new local branch: git checkout -b <branch name>

If git branch is only showing master and not other branches, use git branch -a

To checkout the remote branch you want, run something like this:

git checkout origin/ASAPQuote_Jboss --track

To associate new local branch with remote location:

git push --set-upstream origin <local branch name>

To get code from remote origin via merge method

git fetch then git merge

1. To abort a merge: git merge –abort

2. Here is how you can tell difference between your local branch and what is in gitlab:

   git diff ESAPQuote_Jboss remotes/origin/ESAPQuote_Jboss

3. To add uncommitted files to your local staging area, use: git add .

4. How to discard untracked directories and files in the current working directory: git clean -fd

5. How to untrack a file that is already tracked, but you don’t want to lose the changes: git rm --cached q2oEUR/.settings/org.eclipse.wst.common.component

6. To push your code to remote git push or git push origin master or git push origin <other branch>

7. To produce a list of history of all branches you have locally git log --oneline --graph --decorate --all

8. Get back to your last commit, 1st run command in #7 & get ID of your last commit, then: git reset --hard 029842e (this is the ID of a particular commit)

9. To reset your local code to what is in local head: git reset --hard HEAD

10. To set your local master exactly equal to the remote master (discarding any local changes), use this command: git reset --hard origin/master

11. Note – if you fetch/merge (or pull) and you’re getting permission denied messages and files are being deleted which you know shouldn’t be deleted, close down your IDE’s (Eclipse/VS Code), revert back to your last commit and try again. The IDE’s or server may have file locks.

12. To check your git configuration: git config --global --list

13. To update your git configuration: vi ~/.gitconfig

14. To see how far out of sync with origin/master git fetch origin; git diff origin/master <path>/<file name>

15. To test a merge with no commit git merge --no-commit --no-ff <branch name>

16. If you get a merge with conflicts:

    1. Go and fix the files (it can be in an IDE, e.g. VS Code or Eclipse, or another editor such as Notepad++)
    2. Then save the files
    3. Then run git status. You will probably see a bunch of green entries (already added to stage because they were automatically merged). But you will see the files that you manually fixed in red.
    4. Run “git add .”, which will add the files you changed to stage.
    5. Run git status again, and all files should be green.
    6. Then run git commit -m “<comment>” and it will commit the automatically merged and manually fixed (merged) files.
    7. git status should reveal a clean working directory
    8. Then you may push the changes upstream

17. To update branch from master:

    1. git checkout master
    2. git pull
    3. git checkout <branch name>
    4. git merge master
    5. merge if necessary
    6. test the code
    7. commit merged changes
    8. push merged changes

18. How to create a branch from a tag:

    1. First, query all the tags for the one you want (in this case, I’m looking for build 138): git tag | grep 138
    2. Invoke git branch <branch-name> <tag-name> git branch ibmsw-problem q2oNAJboss-Q2O_NA_JBOSS_DEV_Deploy-138
    3. Then checkout that new branch: git checkout ibmsw-problem

19. To show information about the remote associated with your local branch: git remote show origin

PHP

How to read image metadata to determine orientation (among other things)

$exif_data = exif_read_data("img/church_photos/" . $galleryDirectory . "/" . $fileinfo->getFilename(), 0, true);
Then, to get any values out of the exif data, just use var_dump
In my case, I was trying to find the orientation. As a side note, if you need to look at the EXIF data for any image, go to this site: http://exif.regex.info/

I used this code to read the orientation value from the exif data:

if(!empty($exif_data['IFD0']['Orientation'])) {
	error_log('Image orientation ' . $exif_data['IFD0']['Orientation'] . ' FOUND for img/church_photos/' . $galleryDirectory . '/' . $fileinfo->getFilename() . '...');
	if ($exif_data['IFD0']['Orientation'] == 6) {
		$imageRotateValue = 90;
	}
} else {
	error_log('Image orientation MISSING for img/church_photos/' . $galleryDirectory . '/' . $fileinfo->getFilename() . '...');
}
$imageRotateStyle = null;
if ($imageRotateValue != -1) {
	$imageRotateStyle = ' style="transform: rotate(' . $imageRotateValue . 'deg);"';
}
error_log('Style = ' . $imageRotateStyle . ' for img/church_photos/' . $galleryDirectory . '/' . $fileinfo->getFilename() . '...');
<img class="img-fluid" src="<?=$galleryImageFullPath?>"<?= $imageRotateStyle != null ? $imageRotateStyle : '' ?> />

SQL Statements

How to get stats using an SQL Query for Oracle:

SELECT TABLE_NAME, NUM_ROWS,TO_CHAR(LAST_ANALYZED,'DD.MM.YYYY HH24:MI:SS'), PCT_FREE, STATUS, USER_STATS
FROM DBA_TABLES 
WHERE OWNER ='SCHEMA_NM' AND TABLE_NAME='TABLE_NM';

Example of create table with PK, FK, Trigger and Grants

ALTER SESSION SET CURRENT_SCHEMA = MY_SCHEMAUSER_OWN;

CREATE TABLE MY_CODE_TABLE
(
  MY_TYPE_CD VARCHAR2(4 CHAR) NOT NULL,
  MY_TYPE_DS  VARCHAR2(4 CHAR) NOT NULL,
  APPL_CREATE_DT      DATE DEFAULT SYSDATE NOT NULL,
  APPL_UPDATE_DT      DATE DEFAULT SYSDATE NOT NULL,
  APPL_CREATE_USER_ID VARCHAR2(241 CHAR) NOT NULL,
  APPL_UPDATE_USER_ID VARCHAR2(241 CHAR)
);

ALTER TABLE MY_CODE_TABLE ADD CONSTRAINT MY_CODE_TABLE_PK PRIMARY KEY (MY_TYPE_CD); 

CREATE OR REPLACE TRIGGER MY_CODE_TABLE_BUR
BEFORE UPDATE ON MY_CODE_TABLE
FOR EACH ROW
BEGIN
  :NEW.APPL_UPDATE_DT := SYSDATE;
END;
/
 
GRANT SELECT ON MY_CODE_TABLE TO MY_USER_READ;
GRANT INSERT, UPDATE, DELETE ON MY_CODE_TABLE TO MY_USER_UPDATE;


CREATE TABLE MY_TRANSACTION_TABLE
(
  MY_SK NUMBER NOT NULL,
  MY_TYPE_CD VARCHAR2(4 CHAR) NOT NULL,
  MY_VALUE_CD VARCHAR2(4 CHAR) NOT NULL,
  APPL_CREATE_DT      DATE DEFAULT SYSDATE NOT NULL,
  APPL_UPDATE_DT      DATE DEFAULT SYSDATE NOT NULL,
  APPL_CREATE_USER_ID VARCHAR2(241 CHAR) NOT NULL,
  APPL_UPDATE_USER_ID VARCHAR2(241 CHAR)
);
ALTER TABLE MY_TRANSACTION_TABLE ADD CONSTRAINT MY_TRANSACTION_TABLE_PK PRIMARY KEY (MY_SK, MY_TYPE_CD, MY_VALUE_CD);

ALTER TABLE MY_TRANSACTION_TABLE
  ADD CONSTRAINT MY_TRANSACTION_TABLE_FK01 FOREIGN KEY (MY_TYPE_CD)
  REFERENCES MY_CODE_TABLE (MY_TYPE_CD);

CREATE OR REPLACE TRIGGER MY_TRANSACTION_TABLE_BUR
BEFORE UPDATE ON MY_TRANSACTION_TABLE
FOR EACH ROW
BEGIN
  :NEW.APPL_UPDATE_DT := SYSDATE;
END;
/

GRANT SELECT ON MY_TRANSACTION_TABLE TO MY_USER_READ;
GRANT INSERT, UPDATE, DELETE ON MY_TRANSACTION_TABLE TO MY_USER_UPDATE;

-- alter a column size
ALTER TABLE MY_CODE_TABLE MODIFY MY_TYPE_DS VARCHAR2(50 CHAR);

Shell Scripting

Use imagemagick to change the orientation of image

There are times when photos taken from iOS devices will have the orientation value in the EXIF data set to 6 causing the image orientation to be "on it's side". In order to fix this from the command line with imagemagick, run a command like this:

convert image3.jpeg -auto-orient image3fixed.jpg

That makes the image be rendered with the proper orientation.

How to kill all java processes in korn shell

ps -ef | grep java | grep -v grep | awk '{print "kill " $2}' | ksh –x

Here is a way to search for classes in a jar on local using cygwin

grep JamServiceFactory c:/axis2-1.4.1/lib/*.jar
Then you’ll get some results back like this:

Binary file c:/axis2-1.4.1/lib/annogen-0.1.0.jar matches
Binary file c:/axis2-1.4.1/lib/xmlbeans-2.3.0.jar matches

Then you can look to see if the exact class including package name exists in the jar:

find c:/axis2-1.4.1/lib/ -name "annogen-0.1.0.jar" -exec jar tvf {} \; | grep -i JamServiceFactory
2427 Sat Dec 11 22:25:58 GMT-07:00 2004 org/codehaus/jam/JamServiceFactory.class
6800 Sat Dec 11 22:25:58 GMT-07:00 2004 org/codehaus/jam/provider/JamServiceFactoryImpl.class

find c:/axis2-1.4.1/lib/ -name "xmlbeans-2.3.0.jar" -exec jar tvf {} \; | grep -i JamServiceFactory
2675 Tue May 22 13:26:08 GMT-07:00 2007 org/apache/xmlbeans/impl/jam/JamServiceFactory.class
7400 Tue May 22 13:26:08 GMT-07:00 2007 org/apache/xmlbeans/impl/jam/provider/JamServiceFactoryImpl.class

To force remove a directory and all of its contents and children, use the following command:

rm –rf <directory name>

How to find out what process is writing to a file

fuser {file}

For example:

fuser /usr/WebSphere/AppServer/profiles/ProdNode1/velocity.log

To run xwindows:

1. Open cygwin
2. Issue command startx
3. From Xwindows
   1. run command xhost +
4. On the host where you are running the gui program, enter the following command:
   1. export DISPLAY=172.16.131.141:0.0

In the above command, use your actual ip address. IMPORTANT: The only exception to this is if you’re using X11 forwarding. In that case do not export the display to your IP, otherwise the X11 forwarding will not work due to there being a firewall in between your PC and the server.

To test this, issue the command xclock - this should display a graphical clock in a window.
On external webservers:

In the PuTTY configuration, make sure X11 forwarding is checked for the profile of the server you want to connect to as shown below:

Make sure to save this setting so you don’t have to do it every time.
Try the xclock command to test whether X11 is working or not. If you su to another user, you must do the following, while in the home directory of the user you “su’d” to. cp /home/<original userid>/.Xauthority . < note the trailing ‘space dot’ >

Next, chmod 666 .Xauthority

Use xclock to test.

How to replace all occurrences of one string with another using VI

:%s/oldstring/newstring/g

Here is a way to clear a log file while an app is running:

cat /dev/null > [file name / path]

Here is an example:

cat /dev/null > /usr/WebSphere/AppServer/profiles/TestNode2/logs/q2o01b/native_stderr.log

This will result in the file size being set to zero and the file contents being thrown away!

Script to recursively replace one string with another

The script is currently in the /javadumps file system on london1. Here are the contents of it:

#!/bin/sh
# first arg: File Pattern; e.g "*.xml"
# second arg: pattern to search for; e.g. "find string"
# third arg: replace string; e.g. "replace string"

if [ $# -lt 3 ] ; then
    echo -e "Wrong number of parameters."
    echo -e "Usage:"
    echo -e " renall 'filepat' findstring replacestring\n"
    exit 1
fi
#echo $1 $2 $3
for i in `find . -name "$1" -exec grep -l "$2" {} \;`
do
    mv "$i" "$i.sedsave"
    sed "s/$2/$3/g" "$i.sedsave" > "$i"
    echo $i
    #rm "$i.sedsave"
done

Turning off / on the Highlighting on Linux VI

to turn off highlighting on a VI editor in Linux edit the ~/.viminfo file and change the highlighting param from H to h

Then if you want to turn it back on temporarily, issue:

:set hlsearch

Set up SCP / SSH without password prompt:

While signed in on the “source” box as the user who will be doing the SSH or SCP run this command from the home directory for that user:

ssh-keygen -t rsa -f .ssh/id_rsa

Then it will create a file called ‘id_rsa.pub’.

Then log onto the target box (that you will be SCPing or SSHing into) as the user you will be connecting as. In the /home/username/.ssh directory see if there is already a file called “authorized_keys”. If not, create one and put the contents of the id_rsa.pub created on the source box into it. The contents may look something like this:

ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEA1XlwDreSZScOWkrupLjbJmGZD1szrnn6prKiIS4/QTPZxapkomBqjTIt07JZS0vrEwwDBzRXOnOmJGaGDzCcdhM8dmJ4QPkhyfRpHBVPRxAS8tsVHGIxJYo33SudY27rd2P/zaqV+0pVoUlZzu5snDvgmz34u3/oQNxXZ3k1XMs= wasadmin@cux120vig

If the file authorized_keys already exists, then just append to the end of it. Save the file.

That’s it – you will be able to SSH or SCP without being challenged for a password.

Note – if this doesn’t work, then it may be permissions related. It didn’t work for me on AIX(source) -> Linux(target) one time and I ran this on the target Linux box:

chmod 440 /home/wily/.ssh/authorized_keys

This is because what I found on this on a forum post:

http://www.unix.com/red-hat/12233-authorized_keys-passwordless-login.html

"Here's one thing to check....authorized_keys will be ignored if it is writable or could be replaced by anyone other than you. So $HOME must be writable only by you. Ditto $HOME/.ssh and $HOME/.shh/authorized_keys. This also applies to the parent directory of $HOME all the way back to /."

CURL Post Command

curl -d '{"field1": "9002028","field2": 121419788,"field3": 1}' -H "Content-Type: application/json" -X POST http://my.dns.com/myContextRoot/mycontroller/myendpoint 

Send email using mailx

currDate=`date -d '7 hour ago' "+%m/%d/%Y %H:%M:%S"`
cat /home/myuser/errors.log | mailx -S smtp=smtprelay.my.domain.com -s "My Subject at ${currDate}" "my-group-email@domain.com"

MongoDB

Java

Java 8 +

How to initialize an ArrayList with double curly brace intialization

var myList = new ArrayList<String>(){{
    add("My List Item");
}};

See this page for other ways to initialize an ArrayList in 1 line: https://www.baeldung.com/java-init-list-one-line

Intellij

How to Generate JPA/Hibernate DB Entity Classes from Schema

1. Open the Persistence Panel:
2. Right click in the panel and select "Generate Persistence Mapping" --> "by Database Schema"
3. In the popup, select the Data Source (if pre-configured) and the package where you want the code to be generated.
4. Select the grid where all the table names show up and start typing the source table name from which you want to generate the entity
5. Note - if the table you want to generate an entity from does not show up in the list, you may need to use the refresh button. If you refresh and the table name still does not show up, you may need to reopen the popup.
6. Check the table(s) you want to generate entities for (and all the columns will automatically be selected). Then click OK and after answering a confirmation, the classes will be generated.

Keyboard shortcuts

1. Method List - Ctl + F12
2. Call Hierarchy - Ctl + Alt + H
3. Step Over - F8
4. Step Into - F7
5. Resume - F9
6. Go to Line - Ctl + G
7. Open Breakpoints popup Ctl + Shift + F8
8. Generate Javadoc comment for element - Alt + Enter on element and select "Add Javadoc" from menu
9. Go back to previous location in code - Ctl + Alt + Back Arrow
10. Find usages of field or method - Alt + F7
11. Rename field or method - Shift + F6
12. Optimize imports - Ctl + Alt + O
13. Show method parameter info for method - Ctl + P
14. To open a scratchpad without modifying project files - Ctl + Alt + Shift + Insert
15. To view what is on the clipboard - Ctl + Shift + V

Other Intellij Stuff

If deleting a folder somewhere under .m2 and you want to get the jar to redownload

From Intellij, right click on project and select Maven -> Reimport

How to set an exception breakpoint:

Press Ctrl+Shift+F8 or select Run | View Breakpoints from the main menu.

In the Breakpoints dialog, press Alt+Insert or click the Add button, and select Java Exception Breakpoint or JavaScript Exception Breakpoint.

In the Enter Exception Class dialog, specify an exception class from the library or from your project.

How to locate the IDE logs

Help --> Show Log in Explorer (near the middle of the menu)

How to set up comment templates (such as your intials and the date)

1. Go to the Settings Page
2. Search for Live Templates
3. Select the "other" category
4. Click the "+" button
5. Select "Live Template"
6. Give an abbreviation - this will be what you start typing and press Ctl + Space to do the completion
7. Define what contexts it will be available in (such as the Java category)
8. You can define variables such as date and time - here is an example: // SW [$DATE$ $TIME$] $END$
9. Those variables can be populated by a pre-defined function (in this case date() and time()).

How to reload classes without restarting the server

Ctl + F10 - then in the popup, select "Update classes and resources"

"release version 5 not supported" error

If you get the "release version 5 not supported" error, go to Settings -> Build, Execution, Deployment -> Compiler -> Java Compiler and check/correct the Per-module bytecode version level. Make sure it matches what you think. In my case it was saying 1.5, so I had to switch it to 11 to match what I was expecting.

To ensure classes/resources are reloaded at runtime of server

Run -> Edit Configurations. Then, on the "Server" tab the field "On 'Update' action" field should be changed to "Update Classes and Resources"

There is an issue in running functional tests in Intellij (It complains about module spring-core not being open to the module where the test lives)

Through some experimentation, I found out that you can temporarily give it a special tag like this:
Then create a test configuration like this:
Then it works fine. I’m not quite sure why this makes it work – something about the module system. Anyway, it is a decent workaround.

Mockito

To return argument passed in, use an ArgumentCaptor:

For example:

// inside the setUp() with annotation @BeforeEach
ArgumentCaptor<CopyQuoteParam> param = ArgumentCaptor.forClass(CopyQuoteParam.class);
Mockito.when(quoteService.copyQuote(param.capture())).thenAnswer(invocation -> param.getValue().getQuote());
// then, later in the test code - invoke method that will ultimately call the mocked method

To count how many times a method was called use Mockito.verify

For example:

Mockito.verify(statusMessageService, Mockito.times(5)).addCallStatus(any(), any());

In this case if statusMessageService.addCallStatus(String, String) was not called exactly 5 times, the test would fail.

VS Code

Shortcuts

1. List Methods/Fields - Ctl + Shift + o (then start typing the method or field you want to find)
2. Go to definition - F12

Comment Templates

Visit this page and it desribes how: https://code.visualstudio.com/docs/editor/userdefinedsnippets

Here is an example of setting up a custom inline comment with my initials, the current date/time and the cursor at the end:

{
	"Comment by me": {
		"prefix": "sw",
		"body": "$LINE_COMMENT SW[$CURRENT_DAY_NAME_SHORT $CURRENT_DATE/$CURRENT_MONTH/$CURRENT_YEAR_SHORT $CURRENT_HOUR:$CURRENT_MINUTE:$CURRENT_SECOND] $0",
		"description": "Insert a comment with my initials and date/time"
	}
}

To edit these settings in the future, open the command palette (Ctl + Shift + P) and type snippet and there will be an entry that says Preferences: Configure User Snippets. Select that entry and another drop down list will be shown - then select the snippets file that you'd previously saved to edit it again.

Maven

Spring

REST

Swagger Code Gen Steps

Note - If you don't want to go through the following steps, you can visit this website and it will generate the model for you with the proper annotations:
http://www.jsonschema2pojo.org/

1. Clone git repo for the swagger-codegen tool into some directory: git clone https://github.com/swagger-api/swagger-codegen.git
2. Run maven to build it: mvn clean install
3. Run the following command to generate the sources: java -DdebugModels -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar generate --library jersey1 -i swagger-file.json -l java -o generated-source
4. Note the following things about this command
   1. -DdebugModels – it can be taken out, just for trying to troubleshoot this tool
   2. The goal is generate
   3. --library jersey1 – is critical – this causes the source code to be generated using JSON annotations rather than GSON
   4. -i getSAP46CostPrice-swagger-file.json – this is the JSON schema file
      1. Click on API Gallery on the top tabs
      2. Click on “View Details >>” button under “getSAP46CostPrice”
      3. Click on “Export API as” and select “JSON” and click export and you will get a JSON schema downloaded. That is the file referred to in the command with -i 5.-l java – this is “L” in lower case – represents the language.
   5. -o generated-source – this is the output directory
5. Then import existing maven project into eclipse and select the ‘generated-source’ directory as the root directory.
6. Fix any compile errors
7. Copy in the JSON schema file to the project
8. then export the jar selecting only the io.swagger.client.model directory and the JSON schema file
9. Upload that file to the Nexus repository with the appropriate version number - here is a sample command: mvn deploy:deploy-file -Dfile=<jar file path/name> -DrepositoryId=nexus -Durl=http://my.nexus.repo:8080/repository/maven-releases -Dversion=4.0.0 -DgroupId=q2o.46 -DartifactId=ws-my-service
10. Make the POM and code updates in the codebase.

Swagger - How to Auto-Generate a Swagger Page with documentation for your API

In the Java Web Config class (used to be web.xml), put something like this:

    @Bean
    public Docket api(ServletContext servletContext) {
        Docket docket=  new Docket(DocumentationType.SWAGGER_2)
            .select()
            .apis(RequestHandlerSelectors.basePackage("com.myco.myapp.ws"))
            .paths(PathSelectors.any())
            .build().apiInfo(apiInfo());
        return docket;
    }

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("swagger-ui.html")
          .addResourceLocations("classpath:/META-INF/resources/");
     
        registry.addResourceHandler("/webjars/**")
          .addResourceLocations("classpath:/META-INF/resources/webjars/");
    }
    
    @Bean
    public ApiInfo apiInfo() {
        Contact contact = new Contact("My team.", "", "my-team@myco.com");
        return new ApiInfo("My Team's APIs", "Information related to api exposed by our system.", "1.0",
                "", contact, "My internal API",
                "", new ArrayList<>());
    }

Also, you need to put the following annotation at the top of that web configuration class (in addition to all the other annotations you have):
@EnableSwagger2

Then add the following dependencies to your POM for that WAR project:

<dependency>
	<groupId>io.springfox</groupId>
	<artifactId>springfox-swagger2</artifactId>
	<version>2.9.2</version>
</dependency>
<dependency>
	<groupId>io.springfox</groupId>
	<artifactId>springfox-swagger-ui</artifactId>
	<version>2.9.2</version>
</dependency>
<dependency>
	<groupId>com.google.guava</groupId>
	<artifactId>guava</artifactId>
	<version>20.0</version>
</dependency>
<dependency>
	<groupId>io.springfox</groupId>
	<artifactId>springfox-swagger-common</artifactId>
	<version>2.9.2</version>
</dependency>

If you've configured everything correctly, then it will generate a web page of documentation (and a downloadable swagger JSON schema file) that can be viewed. Here is a sample URL:
http://myapp.myco.com/myWarName/controller/swagger-ui.html

JPA-Hibernate

Here is how to create an "in" query using CriteriaBuilder:

var in = cb.in(tableRoot.get("colName"));  
colNames.forEach(in::value);  
cq.where(in);  

Other

Here is a link to an online code editor:

Note - it supports Angular, React and Vue (in addtion to vanilla javascript) https://codesandbox.io/

How to access Nearly Free Speech (nearlyfreespeech.net) without password prompt

1. Login to your member account
2. Switch to the Profile tab
3. On the green "Action" menu on the right, click on the "Add SSH Key" link
4. In the input box, copy and paste the contents of your public key (e.g. /home/myuser/.ssh/id_rsa.pub
5. Then you should be able to use ssh and scp without entering password (e.g. for automated tasks such as nightly backup)

Tivoli

In the file /opt/pdweb/etc/webseald-default.conf, there is an entry inactive-timeout. It can be set to something like 14,400 seconds (4 hours). This is what controls the amount of time that a user can be inactive before they will get authentication challenge on the next request.

On the WebSEAL logs, sometimes there is a message “The account for user %s has been temporarily locked due to too many failed login attempts”. Temporarily, in our can mean 10 minutes (600 seconds) for example. In order to find out the current value, use pdadmin:

1. pdadmin  
2. pdadmin> login  
3. Enter User ID: <user id>  
4. Enter Password: <pwd>  
5. pdadmin sec_master> policy get disable-time-interval  
                         Disable time interval: 600

In order to delete a person from ISIM, go to: /opt/IBM/itim/extensions/6.0/examples/ws/bin/unix/ and run:

./wsPersonService.sh -operationName?deletePerson -principal?"<actual ID goes here>" -credential?"<actual password goes here>" -filter?"(&(cn=Joe Smith)(sn=Smith))"

CSS

Bootstrap 4

To make a div be flexbox, use the class "d-flex"

Yarn

If getting this error:

error An unexpected error occurred https://registry.yarnpkg.com/@angular/common/-/common-7.0.3.tgz "unable to get local issuer certificate"

The run this command:

yarn config set strict-ssl false

Pikaday import in typescript file causing AOT build inside a Docker container on Linux

If you're getting an error indicating it can't find Module for pikaday when running an angular AOT build with yarn (even though the AOT build works on the local DEV box) and you have an import like this:

import * as Pikaday from "Pikaday";

Switch it over to an import like this:

import Pikaday from "node_modules/pikaday/pikaday.js";

Bit of a brute force solution, but it works.

Angular

Online IDE for Angular (and other web frameworks) - Stack Blitz:

You can sign in with your github account: https://stackblitz.com/

How to run Angular Karma unit tests with Jasmine (with optional Chrome debugging)

run ng test, which will launch the Jasmine test runner in the Chrome web browser. On the Jasmine test runner, there is a debug button in the upper right of the browser window. If you click that a new window opens. Then you can open the developer tools and set breakpoints as normal.

How to create a unit test in angular

1. Create a spec file for your test suite
2. Invoke the describe function with 2 args: description and a fat arrow function
3. Inside the describe fat arrow function, invoke the it function with 2 args: description and fat arrow function
4. Write the code to set up the test conditions
5. Write one or more expect functions with the calculated value, chaining (for example) toEqual with an expected value passed in.

How to disable a test in karma/jasmine

To enable a suite of tests, instead of putting it in a "describe()" function, but the test in an "xdescribe()" function. To just disable a single test, change "it()" function to "xit()". See this article: https://davidtang.io/2016/01/03/controlling-which-tests-run-in-jasmine.html

How to debug Jest unit tests in VS Code

I learned this approach from this blog post: https://www.basefactor.com/using-visual-studio-code-to-debug-jest-based-unit-tests

1. Create a launch.json file in the ".vscode" directory under the workspace root (note - if .vscode directory doesn't exist, create it).
2. Alternatively, you can go to the Debug tab on the left, and at the top create a new configuration (as described at the website above)
3. Your launch.json can be configured like this:

{
    "version": "0.2.0",
    "configurations": [
        {
        "type": "node",
        "request": "launch",
        "name": "Debug Jest Tests",
        "program": "${workspaceRoot}/node_modules/jest/bin/jest.js",
        "args": ["--verbose", "-i", "--no-cache"],
        "console": "integratedTerminal",
        "internalConsoleOptions": "neverOpen"
        }
    ]
}

4. Then, put a breakpoint somewhere in the code to be tested.
5. Then, start the debugger from the top menu (Debug --> Start Debugging) or F5
6. All Jest tests should start running
7. When the execution hits the line at which you put the breakpoint, it will stop.
8. In the debug pane on the left, you should be able to inspect local variables, etc.

How to run a single Jest test:

./node_modules/jest-cli/bin/jest.js src/app/mymodule/myfolder/my.test.spec.ts

How to mock the implementation of a static method for class in Jest:

  jest.spyOn(MyTypescriptClass, "myStaticMethodName").mockImplementation((propertyName: string, properties: { [index: string]: string }) => {
    if (propertyName === "my.prop.1") {
      return "ER,E2,A2,UB".split(",");
    } else if (propertyName === "my.prop.2") {
      return "WZ,ZL,SZ,10".split(",");
    }
  });

How to put HTML inside NG Bootstrap Tooltips

Let's say you have a list of messages that you want to put in a tooltip:

messages: string[] = ['message 1', 'message 2'];

Then you can add an ng-template inside the html template file:

<ng-template #tipContent>
  <ul class="list-unstyled">
    <li *ngFor="let msg of messages">
      {{msg}}
    </li>
  </ul>
</ng-template>

Then, refer to the template on the element where you want the tooltip

<div class="modal-footer">
  <span class="mr-2" placement="left"
    [ngbTooltip]="tipContent">
    <button class="btn btn-primary" (click)="onSubmit()">Submit</button>
  </span>
</div>

Then the tooltip will show up like this:

Here is a sample stackblitz where you can acheive dynamic tooltips with hover:

https://stackblitz.com/edit/dynamic-ngb-tooltips

Links

Good guide to Flexbox: https://css-tricks.com/snippets/css/a-guide-to-flexbox/

Azure DevOps

To set the master branch policy to prevent push

In the project:

1. Go to Project Settings (on the very bottom left of the screen)
2. Then in the menu on the left, click on "Repositories"
3. Find your repository
4. Expand the Branches
5. Find the master branch and click on it
6. Click on the Policies tab
7. Check off the "Require a minimum number of reviewers" and enter at least 1
8. Fill out rest of screen with whatever makes sense:
9. If this is all you do, then, you will still be able to push from a local branch. You will get a message like this:

remote: warning: This push has bypassed configured policies for the branch.                                                                       
To https://anycorp.visualstudio.com/ANY/_git/ANY-Team-CODE

   c2c6b5b..a15e167  master -> master                                                                                                  

10. Then make this change:

That's it - then you won't be able to push from a local master branch to this remote master branch.