100% developed

Interfaces

From Wikibooks, open books for an open world
Jump to navigation Jump to search

Navigate Classes and Objects topic: v  d  e )

An interface is an abstraction of class with no implementation details. For example, java.lang.Comparable is a standard interface in Java. You cannot instantiate an interface. An interface is not a class but it is written the same way. The first difference is that you do not use the class keyword but the interface keyword to define it. Then, there are fields and methods you cannot define here:

  • A field is always a constant: it is always public, static and final, even if you do not mention it.
  • A method must be public and abstract, but it is not required to write the public and abstract keywords.
  • Constructors are forbidden.

An interface represents a contract:

Computer code Code listing 4.14: SimpleInterface.java
public interface SimpleInterface {
    public static final int CONSTANT1 = 1;
    int method1(String parameter);
}

You can see that the method1() method is abstract (unimplemented). To use an interface, you have to define a class that implements it, using the implements keyword:

Computer code Code listing 4.15: ClassWithInterface.java
public class ClassWithInterface implements SimpleInterface {
    public int method1(String parameter) {
        return 0;
    }
}

A class can implement several interfaces, separated by a comma. Java interfaces behave much like the concept of the Objective-C protocol. It is recommended to name an interface <verb>able, to mean the type of action this interface would enable on a class. However, it is not recommended to start the name of an interface by I as in C++. It is useless. Your IDE will help you instead.

Interest[edit | edit source]

If you have objects from different classes that do not have a common superclass, you can't call the same method in those classes, even if the two classes implement a method with the same signature.

Computer code Code listing 4.16: OneClass.java
public class OneClass {
    public int method1(String parameter) {
        return 1;
    }
}
Computer code Code listing 4.17: AnotherClass.java
public class AnotherClass {
    public int method1(String parameter) {
        return 2;
    }
}
Warning Code section 4.16: Impossible call.
public static void main(String[] args) {
    doAction(new OneClass());
    doAction(new AnotherClass());
}

public void doAction(Object anObject) {
    anObject.method1("Hello!");
}

The solution is to write an interface that defines the method that should be implemented in the two classes as the SimpleInterface in the Code listing 4.14 and then both classes can implement the interface as in the Code listing 4.15.

Example Code section 4.17: Interface use.
public static void main(String[] args) {
    doAction(new ClassWithInterface());
    doAction(new AnotherClassWithInterface());
}

public void doAction(SimpleInterface anObject) {
    anObject.method1("Hello!");
}

You can also implement this using a common super class but a class can only inherit from one super class whereas it can implement several interfaces.

Java does not support full orthogonal multiple inheritance (i.e. Java does not allow you to create a subclass from two classes). Multiple inheritance in C++ has complicated rules to disambiguate fields and methods inherited from multiple superclasses and types that are inherited multiple times. By separating interface from implementation, interfaces offer much of the benefit of multiple inheritance with less complexity and ambiguity. The price of no multiple inheritance is some code redundancy; since interfaces only define the signature of a class but cannot contain any implementation, every class inheriting an interface must provide the implementation of the defined methods, unlike in pure multiple inheritance, where the implementation is also inherited. The major benefit of that is that all Java objects can have a common ancestor (a class called Object).

When overriding methods defined in interfaces there are several rules to be followed:

  • Checked exceptions should not be declared on implementation methods other than the ones declared by the interface method or subclasses of those declared by the interface method.
  • The signature of the interface method and the same return type or subtype should be maintained when implementing the methods.
  • All the methods of the interface need to be defined in the class, unless the class that implements the interface is abstract.

Extending interfaces[edit | edit source]

Execution of this example on BlueJ.

An interface can extend several interfaces, similar to the way that a class can extend another class, using the extends keyword:

Computer code Code listing 4.18: InterfaceA.java
public interface InterfaceA {
  public void methodA();
}
Computer code Code listing 4.19: InterfaceB.java
public interface InterfaceB {
  public void methodB();
}
Computer code Code listing 4.20: InterfaceAB.java
public interface InterfaceAB extends InterfaceA, InterfaceB {
  public void otherMethod();
}

This way, a class implementing the InterfaceAB interface has to implement the methodA(), the methodB() and the otherMethod() methods:

Computer code Code listing 4.21: ClassAB.java
public class ClassAB implements InterfaceAB {
  public void methodA() {
    System.out.println("A");
  }

  public void methodB() {
    System.out.println("B");
  }

  public void otherMethod() {
    System.out.println("foo");
  }

  public static void main(String[] args) {
    ClassAB classAb = new ClassAB();
    classAb.methodA();
    classAb.methodB();
    classAb.otherMethod();
  }
}

Doing so, a ClassAB object can be casted into InterfaceA, InterfaceB and InterfaceAB.

Test your knowledge

Question 4.2: Consider the following interfaces.

Computer code Question 4.2: Walkable.java
public interface Walkable {
    void walk();
}
Computer code Question 4.2: Jumpable.java
public interface Jumpable {
    void jump();
}
Computer code Question 4.2: Swimable.java
public interface Swimable {
    void swim();
}
Computer code Question 4.2: Movable.java
public interface Movable extends Walkable, Jumpable {
}

List all the methods that an implementing class of Movable should implement.

Answer
  • walk()
  • jump()
Computer code Answer 4.2: Person.java
public class Person implements Movable {
    public void walk() {
        System.out.println("Do something.");
    }

    public void jump() {
        System.out.println("Do something.");
    }
}

Question 4.3: Consider the following classes and the following code.

Computer code Question 4.3: ConsoleLogger.java
import java.util.Date;

public class ConsoleLogger {
    public void printLog(String log) {
        System.out.println(new Date() + ": " + log);
    }
}
Computer code Question 4.3: FileLogger.java
import java.io.File;
import java.io.FileOutputStream;

public class FileLogger {
  public void printLog(String log) {
    try {
      File file = new File("log.txt");
      FileOutputStream stream = new FileOutputStream(file);
      byte[] logInBytes = (new Date() + ": " + log).getBytes();

      stream.write(logInBytes);

      stream.flush();
      stream.close();
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}
Example Question 4.3: Common code.
Object[] loggerArray = new Object[2];
loggerArray[0] = new ConsoleLogger();
loggerArray[1] = new FileLogger();

for (Object logger : loggerArray) {
    // logger.printLog("Check point.");
}

Change the implementation of the code in order to be able to uncomment the commented line without compile error.

Answer

You have to create an interface that defines the method printLog(String) and makes ConsoleLogger and FileLogger implement it:

Computer code Answer 4.3: Logger.java
public interface Logger {
    void printLog(String log);
}
Computer code Answer 4.3: ConsoleLogger.java
import java.util.Date;

public class ConsoleLogger implements Logger {
    public void printLog(String log) {
        System.out.println(new Date() + ": " + log);
    }
}
Computer code Answer 4.3: FileLogger.java
import java.io.File;
import java.io.FileOutputStream;

public class FileLogger implements Logger {
  public void printLog(String log) {
    try {
      File file = new File("log.txt");
      FileOutputStream stream = new FileOutputStream(file);
      byte[] logInBytes = (new Date() + ": " + log).getBytes();

      stream.write(logInBytes);

      stream.flush();
      stream.close();
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}

Now your code has to cast the objects to the Logger type and then you can uncomment the code.

Example Answer 4.3: Common code.
Logger[] loggerArray = new Logger[2];
loggerArray[0] = new ConsoleLogger();
loggerArray[1] = new FileLogger();

for (Logger logger : loggerArray) {
    logger.printLog("Check point.");
}