/**
 * Returns a user object that can be stored in the data store. 
 * The name argument must be alphanumeric. 
 * <p>
 * This method always creates a new user, whether or not a user 
 * with the same name already exists. 
 *
 * @param  name the name given to a new user
 * @return      the newly created user
 * @see         OtherClassOfInterest
 */
 public User createUser(String name) {
 	User user = new User();
 	user.setName(name);
 	return user;
 }

 // creates a user
 public User createUser(String name) {
 	User user = new User(); // a new user is always created
 	user.setName(name);
 	return user;
 }

/*
 * Copyright (C) {year} 47 Degrees, LLC
 * http://47deg.com
 * hello@47deg.com
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/*
 * Copyright (C) {year} 47 Degrees, LLC
 * http://47deg.com
 * hello@47deg.com
 * All rights reserved
 */

/*
 * Copyright (C) {year} {3rdPartyName}
 * {3rdPartUrl}
 * All rights reserved
 * Developed for {3rdPartyName} by:
 *
 * 47 Degrees, LLC
 * http://47deg.com
 * hello@47deg.com
 */

/**
 * Defines the contract for the user related operations 
 * @see User
 */
 public interface UserService {
 }

 /**
 * Implements the UserService connecting and saving the user to the database
 * @see UserService
 */
 public class LocalUserServiceImpl implements UserService {
 }

 /**
 * Does not implements the UserService but connects and saves the user to the database
 * @see UserService
 */
 public class UserService {
 }

public List<User> getFriends(User user) {
}

public ArrayList<User> getFriends(User user) {
}

/**
 * User interface or API response (Serialized to JSON or used in view technologies such as JSP)
 */
 public class UserResponse {

 	private String name;

 	public UserResponse(User user) {
 		setName(user.getName());
 	}

 	public String getName() {
 		return this.name;
 	}

 	public void setName(String name) {
 		this.name = name;
 	}

 }

 /**
 * Handles UI interaction and communication to services (Servlets, Spring MVC Controllers, Android activities, Tapestry pages...)
 */
 public class UserController {

 	private UserService userService;

 	public UserResponse onCreateUserFormSubmit(String name) {
 		User user = userService.createUser(name);
 		return new UserResponse(user);
 	}

 }

 /**
 * Implements business logic (Spring Bean Services)
 */
 public interface UserService {

 	User createUser(String name);

 }

 /**
 * Implements the UserService 
 * @see UserService
 */
 public class LocalUserServiceImpl implements UserService {

 	private PersistenceAdapter persistenceAdapter;

 	public User createUser(String name) {
 		User user = new User();
 		user.setName(name);
 		persistenceAdapter.save(user);
 		return user;
 	}

 }

/**
 * Entity that gets persisted to the data store
 */
 public class User {

 	private String name;

 	public String getName() {
 		return this.name;
 	}

 	public void setName(String name) {
 		this.name = name;
 	}

 }

/**
 * Handles persistence (DAO, Cassandra Persistence Adapters, JPA Persistence Adapters)
 */
 public interface PersistenceAdapter {

 	void save(Object object);

 }

 /**
 * Donwloads and sorts the interwebs, all in one method
 */
 public class MagicClass {
 	void doMagic(Object... args) {
 		//5000 lines here
 	}
 }

 public class StringUtils {

 	public static boolean isEmpty(String string) {
 		return string == null || "".equals(string.trim());
 	}

 }

or

public class StringUtils {

 	public static boolean isEmpty(String string) {
 		boolean empty = false;
 		if (string == null) {
 			empty = true;
 		} else if ("".equals(string.trim())) {
 			empty = true;
 		}
 		return empty;
 	}

 }

 public class StringUtils {

 	public static boolean isEmpty(String string) {
 		if (string == null) {
 			return true;
 		} else if ("".equals(string.trim())) {
 			return true;
 		}
 		return false;
 	}

 }

	!active

	active == false

	for (String name: names) {
		doSomething(name);
	}

	for (int i = 0; i < names.length; i++) {
		doSomething(names[i]);
	}	

	log.debug(String.format("found %s items", amount));

	log.debug("found " + amount + " items");	

	try {
		do();
	} catch (SomethingWeCanHandleException ex) {
		log.error(ex);
		notifyUser(ex);
	} finally {
		cleanUp();
	}

	public void doSomething() throws SomethingSomeoneElseCanHandleException {
	}

	try {
		do();
	} catch (Throwable ex) {
		log.error(ex);
	} 

	try {
		do();
	} catch (SomethingWeCanHandleException ex) {
		//do nothing
	} 

List<String> people = Arrays.asList("you", "me");

List people = Arrays.asList("you", "me");

public final class ThisShouldNeverBeExtended {
...
}

public final neverOverrideThisMethod() {
}

private final int thisFielfValueWillNeverChangeOnceSet;

final int thisLocalVariableValueWillNeverChangeOnceSet = 0;

public Object doSomething() {
	Object result = null;
	if (something) {
		result = new Object();
	}
	return result;
}

public void changeName(String name) {
	setName(name);	
}

public void changeName(String name) {
	this.name = name;	
}

public interface PersistenceAdapter {
	...
}

public interface CassandraPersistenceAdapter extends PersistenceAdapter {	
	...
}

public interface JPAPersistenceAdapter extends PersistenceAdapter {	
	...
}

public class HibernateJPAPersistenceAdapterImpl implements JPAPersistenceAdapter {	
	...
}

public class HectorCassandraPersistenceAdapterImpl implements CassandraPersistenceAdapter {	
	...
}

//Obtains the current runtime impl for the persistence adapter.
PersistenceAdapter persistenceAdapter = getPersistenceAdapter();
persistenceAdapter.save(user);

Calendar.getInstance();

public class UserResponse {
	
	private User delegate;

	public UserResponse(User delegate) {
		this.delegate = delegate;
	}

	public String getName() {
		return delegate.getName();
	}

}

public class Earth {
	
	private static Earth instance = new Earth();

	private Earth() {		
	}

	public static Earth getInstance() {
		return instance;
	}

}

public enum Options {
	YES, NO
}

String yes = "YES";
String no = "NO";

public void downloadUrlContents(String url) {
	checkIfHostIsReachable(url);
	saveContentsToFile(url);
}

public void downloadUrlContents(String url) {
	... complex code to see if a host is reachable
	... complex code to turn the remote response into bytes and then serialize to disk
}