View Javadoc
1   /*
2    * junixsocket
3    *
4    * Copyright 2009-2024 Christian Kohlschütter
5    *
6    * Licensed under the Apache License, Version 2.0 (the "License");
7    * you may not use this file except in compliance with the License.
8    * You may obtain a copy of the License at
9    *
10   *     http://www.apache.org/licenses/LICENSE-2.0
11   *
12   * Unless required by applicable law or agreed to in writing, software
13   * distributed under the License is distributed on an "AS IS" BASIS,
14   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15   * See the License for the specific language governing permissions and
16   * limitations under the License.
17   */
18  package org.newsclub.net.unix;
19  
20  import java.io.FileDescriptor;
21  import java.io.IOException;
22  import java.net.SocketAddress;
23  import java.net.SocketException;
24  
25  /**
26   * A selectable channel for stream-oriented connecting sockets.
27   *
28   * @author Christian Kohlschütter
29   */
30  public final class AFUNIXSocketChannel extends AFSocketChannel<AFUNIXSocketAddress> implements
31      AFUNIXSocketExtensions {
32    AFUNIXSocketChannel(AFUNIXSocket socket) {
33      super(socket, AFUNIXSelectorProvider.getInstance());
34    }
35  
36    /**
37     * Opens a socket channel.
38     *
39     * @return The new channel
40     * @throws IOException on error.
41     */
42    public static AFUNIXSocketChannel open() throws IOException {
43      return (AFUNIXSocketChannel) AFSocketChannel.open(AFUNIXSocket::newLenientInstance);
44    }
45  
46    /**
47     * Opens a socket channel, connecting to the given socket address.
48     *
49     * @param remote The socket address to connect to.
50     * @return The new channel
51     * @throws IOException on error.
52     */
53    public static AFUNIXSocketChannel open(SocketAddress remote) throws IOException {
54      return (AFUNIXSocketChannel) AFSocketChannel.open(AFUNIXSocket::newLenientInstance, remote);
55    }
56  
57    @Override
58    public FileDescriptor[] getReceivedFileDescriptors() throws IOException {
59      return ((AFUNIXSocketExtensions) getAFSocket()).getReceivedFileDescriptors();
60    }
61  
62    @Override
63    public void clearReceivedFileDescriptors() {
64      ((AFUNIXSocketExtensions) getAFSocket()).clearReceivedFileDescriptors();
65    }
66  
67    @Override
68    public void setOutboundFileDescriptors(FileDescriptor... fdescs) throws IOException {
69      if (fdescs != null && fdescs.length > 0 && !isConnected()) {
70        throw new SocketException("Not connected");
71      }
72      ((AFUNIXSocketExtensions) getAFSocket()).setOutboundFileDescriptors(fdescs);
73    }
74  
75    @Override
76    public boolean hasOutboundFileDescriptors() {
77      return ((AFUNIXSocketExtensions) getAFSocket()).hasOutboundFileDescriptors();
78    }
79  
80    @Override
81    public AFUNIXSocketCredentials getPeerCredentials() throws IOException {
82      return ((AFUNIXSocketExtensions) getAFSocket()).getPeerCredentials();
83    }
84  }