> For the complete documentation index, see [llms.txt](https://jihoony.gitbook.io/developers-notes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jihoony.gitbook.io/developers-notes/developer/readme/etcs/static-factory-methods-common-naming-conventions.md).

# static factory methods common naming conventions

This list is far from exhaustive:

| naming                      | meaning                                                                                                                                  | example                                                       |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| `from`                      | A *type-conversion method* that takes a single parameter and returns a corresponding instance of this type.                              | `Date d = Date.from(instant);`                                |
| `of`                        | An `aggregation method` that takes multiple parameters and returns an instance of this type that incorporates them.                      | `Set\<Rank\> faceCards = EnumSet.of(JACK, QUEEN, KING);`      |
| `valueOf`                   | A more verbose alternative to `from` and `of`                                                                                            | `BigInteger prime = BigInteger.valueOf(Integer.MAX_VALUE);`   |
| `instance` or `getInstance` | Returns an instance that is described by its parameters (if any) but cannot be said to have the same value.                              | `StackWalker luke = StackWalker.getInstance(options);`        |
| `create` or `newInstance`   | Like `instance` or `getInstance`, except that the method guarantees that each call returns a new instance.                               | `Object newArray = Array.newInstance(classObject, arrayLen);` |
| `get`*Type*                 | Like `getInstance`, but used if the factory method is in a different class. *Type* is the type of object returned by the factory method. | `FileStore fs = Files.getFileStore(path);`                    |
| `new`*Type*                 | Line `newInstance`, but used if the factory method is in a different class. *Type* is the type of object returned by the factory method. | `BufferedReader br = Files.newBufferedReader(path);`          |
| `type`                      | A concise alternative to `get`*Type* and `new`*Type*.                                                                                    | `List\<Complaint\> litany = Collections.list(legacyLitany);`  |