14.2.2. User-defined Packages

These are packages that are created by the programmer to organize their own classes and interfaces.

User-defined packages are collections of classes and interfaces that you create as a programmer. They allow you to group related functionality, which makes your code easier to manage. For instance, if you're developing a software application that includes multiple functionalities such as user management, billing, and reporting, you could create separate packages for each of these functionalities to keep your code organized.

Think of a user-defined package like a filing cabinet where each drawer represents a package. Each drawer may contain folders full of related documents (i.e., classes and interfaces), making it easier for you to find and manage your paperwork rather than having all documents in a single, unorganized heap.

To create a package in Java, use the package keyword followed by the package name at the beginning of the Java source file.

To define a package in your Java code, you start with the 'package' keyword followed by the package name. This line must be at the top of your Java source file. For example, if you're creating utility functions, you might define a package named com.example.util. After defining the package, any classes that are declared in the same source file will belong to that package.

Imagine you're a chef setting up a new kitchen. You label each section of your kitchen according to the type of food you prepare (e.g., baking, grilling, salads). Similarly, by creating packages, you label and organize your classes based on their functionality, creating a neat and efficient development environment.

Let's say we want to create a package named com.example.util for utility classes.

package com.example.util; // Defining a package
public class MathUtils {
    public static int add(int a, int b) {
        return a + b;
    }
    public static int subtract(int a, int b) {
        return a - b;
    }
}

Here, the class MathUtils is part of the com.example.util package.

In this example, we've defined a package called com.example.util, and a class named MathUtils that includes two methods for addition and subtraction. This class will be available for use in other classes that import this package. The MathUtils class organizes mathematical functions, which could be utilized in other parts of an application.

Think of the MathUtils class like a toolset for a mechanic. Just as a mechanic might have a dedicated toolbox for specific tools (like wrenches and screwdrivers), your package groups related classes together, making it easier to locate and use the tools you need for mathematical calculations.

To use a class from a package in another class, you need to import the class using the import keyword.

Once you've defined a user-defined package, you can use its classes in other classes by importing them. This is done by using the 'import' keyword followed by the package name and the class name. You can also use a wildcard (*) to import all classes from a package if needed.

Think of importing a package like renting a tool from a toolkit. If you need a specific tool (class) for a project, you have to grab it from the toolbox (package). If you decide to take the whole set of tools out for convenience, it's like using the wildcard import to access all available classes at once.

--