java
39 lines · 6 steps
Topological sort with Kahn's algorithm
Order a directed graph's nodes so every edge points forward, using in-degree counting and a ready queue.
Explained by
highlit
1import java.util.*;
2
3public class TopologicalSort {
4
5 public static List<Integer> sort(int numNodes, int[][] edges) {
6 List<List<Integer>> adjacency = new ArrayList<>();
7 for (int i = 0; i < numNodes; i++) {
8 adjacency.add(new ArrayList<>());
9 }
10 int[] inDegree = new int[numNodes];
11 for (int[] edge : edges) {
12 adjacency.get(edge[0]).add(edge[1]);
13 inDegree[edge[1]]++;
14 }
15
16 Queue<Integer> ready = new ArrayDeque<>();
17 for (int node = 0; node < numNodes; node++) {
18 if (inDegree[node] == 0) {
19 ready.offer(node);
20 }
21 }
22
23 List<Integer> order = new ArrayList<>();
24 while (!ready.isEmpty()) {
25 int node = ready.poll();
26 order.add(node);
27 for (int neighbor : adjacency.get(node)) {
28 if (--inDegree[neighbor] == 0) {
29 ready.offer(neighbor);
30 }
31 }
32 }
33
34 if (order.size() != numNodes) {
35 throw new IllegalArgumentException("Graph has a cycle; no topological order exists");
36 }
37 return order;
38 }
39}
01 / 01
STEP 01
‹ swipe to step through ›
Walkthrough
Space play
←→ step
click any line
Three takeaways
- 1Kahn's algorithm repeatedly removes nodes with no remaining prerequisites to build a valid ordering.
- 2Tracking in-degree lets you detect exactly when a node becomes ready without rescanning the graph.
- 3If fewer nodes are emitted than exist, the graph must contain a cycle and no ordering is possible.
Related explainers
java
@Component @Converter public class EncryptedStringConverter implements AttributeConverter<String, String> {
Transparent column encryption in Spring & JPA
encryption
aes-gcm
jpa-converter
Advanced
10 steps
java
package com.acme.billing.config; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.boot.context.properties.ConfigurationProperties;
Feature-flagged beans with Spring @ConditionalOnProperty
feature-flags
conditional-beans
strategy-pattern
Intermediate
5 steps
java
public static Map<String, String> parseCookieHeader(String header) { Map<String, String> cookies = new LinkedHashMap<>(); if (header == null || header.isBlank()) { return cookies;
Parsing an HTTP Cookie header in Java
string-parsing
http
url-decoding
Intermediate
6 steps
java
public class TimedSocketReader { private static final int READ_TIMEOUT_MS = 5_000; private static final int CONNECT_TIMEOUT_MS = 3_000;
Reading a socket with connect and read timeouts
sockets
timeouts
io
Intermediate
8 steps
java
public final class EncodingDetector { public enum Encoding { UTF_8, UTF_16LE, UTF_16BE, UTF_32LE, UTF_32BE, ASCII, UNKNOWN
Detecting text encoding from raw bytes in Java
byte-manipulation
encoding-detection
bitwise-operations
Intermediate
8 steps
java
public final class ImportOrganizer { private static final Pattern IMPORT_LINE = Pattern.compile("^import\\s+(static\\s+)?([\\w.]+(?:\\.\\*)?)\\s*;\\s*$");
Sorting Java imports with a regex pass
regex
sorting
text-processing
Intermediate
8 steps
Share this explainer
Here's the card — post it anywhere.
Made with highlit — turn any snippet into a walkthrough like this in about a minute.
Explain your code
Embed this explainer
Drop the interactive walkthrough into a blog or docs. Views never cost a credit.
<iframe src="https://highlit.co/explainers/topological-sort-with-kahn-s-algorithm-explained-java-a508/embed?autoplay=1" width="100%" height="520" loading="lazy" style="border:0"></iframe>
Autoplay is on by default — add ?autoplay=0 to start paused.